std::istream_iterator

来自cppreference.com
< cpp‎ | iterator
定义于头文件 <iterator>
template< class T,

          class CharT = char,
          class Traits = std::char_traits<CharT>,
          class Distance = std::ptrdiff_t >
class istream_iterator: public std::iterator<std::input_iterator_tag,

                                             T, Distance, const T*, const T&>
(C++17 前)
template< class T,

          class CharT = char,
          class Traits = std::char_traits<CharT>,
          class Distance = std::ptrdiff_t >

class istream_iterator;
(C++17 起)

std::istream_iterator 是单趟输入迭代器,从为之创建迭代器的 std::basic_istream 对象读取 T 类型的相继对象,通过调用适当的 operator>> 。实际读取操作在自增,而非解引用迭代器时进行。首个对象可能在构造迭代器时或进行首次解引用时读取。其他情况下,解引用只返回最近读取的对象的副本。

默认构造的 std::istream_iterator 被称为流尾迭代器。合法的 std::istream_iterator 地带底层流尾时,它变得等于流尾迭代器。解引用和进一步自增它导致未定义行为。

std::istream_iterator 的典型实现保有二个数据成员:指向关联 std::basic_istream 对象的指针和最近读取的 T 类型值。

T 必须满足可默认构造 (DefaultConstructible) 、可复制构造 (CopyConstructible) 和可移动赋值 (CopyAssignable) 要求。

目录

[编辑] 成员类型

成员类型 定义
char_type CharT
traits_type Traits
istream_type std::basic_istream<CharT, Traits>

[编辑] 成员函数

构造新的 istream_iterator
(公开成员函数) [编辑]
析构 istream_iterator ,包含缓冲的值
(公开成员函数) [编辑]
返回当前元素
(公开成员函数) [编辑]
推进迭代器
(公开成员函数) [编辑]

[编辑] 非成员函数

比较两个 istream_iterator
(函数模板) [编辑]

[编辑] 成员类型

成员类型 定义
value_type T
difference_type Distance
pointer const T*
reference const T&
iterator_category std::input_iterator_tag

注意:在 C++17 前,这些成员类型要求通过从 std::iterator<std::input_iterator_tag,T,Distance,const T*,const T&> 继承而获得。

[编辑] 注意

读字符时, std::istream_iterator 默认跳过空白符(除非用 std::noskipws 或等价物禁用,而 std::istreambuf_iterator 不跳过。另外, std::istreambuf_iterator 更有效率,因为它避免对每个字符构造并析构一次 sentry 对象的开销。

[编辑] 示例

#include <iostream>
#include <sstream>
#include <iterator>
#include <numeric>
 
int main()
{
    std::istringstream str("0.1 0.2 0.3 0.4");
    std::partial_sum(std::istream_iterator<double>(str),
                     std::istream_iterator<double>(),
                     std::ostream_iterator<double>(std::cout, " "));
}

输出:

0.1 0.3 0.6 1

[编辑] 参阅

写入 std::basic_ostream 的输出迭代器
(类模板) [编辑]
std::basic_streambuf 读取的输入迭代器
(类模板) [编辑]