std:: istream_iterator

std::istream_iterator 是一种单次遍历输入迭代器，通过调用相应的 operator >> ，从构造时指定的 std::basic_istream 对象中连续读取类型为 T 的对象。实际读取操作在迭代器递增时执行，而非解引用时。首个对象在迭代器构造时即被读取。解引用操作仅返回最近读取对象的副本。

默认构造的 std::istream_iterator 被称为 流结束 迭代器。当有效的 std::istream_iterator 到达底层流的末尾时，它会变得与流结束迭代器相等。此时再对其进行解引用或递增操作将引发未定义行为。即使底层流的状态发生变化，流结束迭代器也会始终保持流结束状态。除非重新赋值，否则它无法再变为非流结束迭代器。

std::istream_iterator 的典型实现包含两个数据成员：一个指向关联 std::basic_istream 对象的指针，以及最近读取的类型为 T 的值。

T 必须满足 DefaultConstructible 、 CopyConstructible 和 CopyAssignable 要求。

成员类型

成员函数

非成员函数

注释

在读取字符时， std::istream_iterator 默认跳过空白字符（除非使用 std::noskipws 或等效方法禁用），而 std::istreambuf_iterator 则不会跳过。此外， std::istreambuf_iterator 效率更高，因为它避免了为每个字符构造和析构哨兵对象的开销。

示例

#include <algorithm>
#include <iostream>
#include <iterator>
#include <numeric>
#include <sstream>
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, " "));
    std::istringstream str2("1 3 5 7 8 9 10");
    auto it = std::find_if(std::istream_iterator<int>(str2),
                           std::istream_iterator<int>(),
                           [](int i){ return i % 2 == 0; });
    if (it != std::istream_iterator<int>())
        std::cout << "\nThe first even number is " << *it << ".\n";
    //流中剩余" 9 10"
}

0.1 0.3 0.6 1 
第一个偶数是8。

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的C++标准。

参见