命名空间
变体
操作

std::istream_iterator

来自 cppreference.cn
 
C++
 
迭代器库
迭代器概念
迭代器原语
算法概念与工具
间接可调用概念
常用算法要求
工具
迭代器适配器
 
std::istream_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 是一个单通道输入迭代器，它通过调用适当的 operator>> 从它所构造的 std::basic_istream 对象中读取连续的 T 类型对象。实际的读取操作在迭代器递增时执行，而不是在解引用时执行。第一个对象在迭代器构造时读取。解引用只返回最近读取对象的副本。

默认构造的 std::istream_iterator 被称为流结束迭代器。当一个有效的 std::istream_iterator 到达底层流的末尾时，它会变得与流结束迭代器相等。进一步解引用或递增它将导致未定义行为。即使底层流状态改变，流结束迭代器也保持在流结束状态。如果没有重新赋值，它不能再成为非流结束迭代器。

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

T 必须满足 DefaultConstructible（默认可构造）、CopyConstructible（可复制构造）和 CopyAssignable（可复制赋值）要求。

目录

[编辑] 成员类型

成员类型 定义
iterator_category std::input_iterator_tag
value_type T
difference_type Distance
pointer const T*
reference const T&
char_type CharT
traits_type 特性
istream_type std::basic_istream<CharT, Traits>

成员类型 iterator_category、value_type、difference_type、pointer 和 reference 需要通过继承自 std::iterator<std::input_iterator_tag, T, Distance, const T*, const T&> 来获取。

 (C++17 前)

[编辑] 成员函数

 构造一个新的 istream_iterator
(公共成员函数) [编辑]
 析构一个 istream_iterator，包括缓存值
(公共成员函数) [编辑]
 返回当前元素
(公共成员函数) [编辑]
 前进迭代器
(公共成员函数) [编辑]

[编辑] 非成员函数

(在 C++20 中移除)
 比较两个 istream_iterator
(函数模板) [编辑]

[编辑] 注意

读取字符时，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" left in the stream
}

输出

0.1 0.3 0.6 1 
The first even number is 8.

[编辑] 缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告 应用于 发布时的行为 正确的行为
P0738R2 C++98 第一次读取可能会推迟到第一次解引用 总是在构造函数中执行

[编辑] 另请参阅

 写入std::basic_ostream的输出迭代器
(类模板) [编辑]
 从std::basic_streambuf读取的输入迭代器
(类模板) [编辑]
取自“https://cppreference.cn/mwiki/index.php?title=cpp/iterator/istream_iterator&oldid=159916”