std::istreambuf_iterator

template< class CharT, class Traits = std::char_traits<CharT> >
class istreambuf_iterator
    : public std::iterator<std::input_iterator_tag,
                           CharT, typename Traits::off_type,
                           /* unspecified */, CharT>

template< class CharT, class Traits = std::char_traits<CharT> >
class istreambuf_iterator;

std::istreambuf_iterator是一个单遍输入迭代器，它从 std::basic_streambuf对象读取连续字符，该对象是其构造时指定的。

默认构造的 std::istreambuf_iterator 被称为 流结束迭代器。当 std::istreambuf_iterator 到达底层流的末尾时，它会变得与流结束迭代器相等。进一步解引用或自增它会导致未定义行为。

成员类型

成员类型 pointer 通常为 CharT* （参见 下文 ）。

成员函数

非成员函数

注释

LWG问题659的决议引入了 operator - > 。预期对于给定的 std::istreambuf_iterator i ，表达式 ( * i ) . m 与 i - > m 应具有相同效果。

然而，该决议并未对其行为提供正式规范。因此实际实现存在差异，包括返回 nullptr 、返回临时对象地址，或根本不提供该成员。其预期行为几乎无法实现，最终通过 LWG issue 2790 的决议被移除。

LWG问题 659 的解决方案同时将成员类型 pointer 设为未指定类型，以便允许 operator-> 返回代理对象。这是为了在 CharT 不是类类型时仍能编译通过 operator-> 操作。

示例

#include <iostream>
#include <iterator>
#include <sstream>
#include <string>
int main()
{
    // 典型用例：表示为迭代器对的输入流
    std::istringstream in{"Hello, world"};
    std::istreambuf_iterator<char> it{in}, end;
    std::string ss{it, end};
    std::cout << "ss has " << ss.size() << " bytes; "
                 "it holds \"" << ss << "\"\n";
    // 单次遍历特性的演示
    std::istringstream s{"abc"};
    std::istreambuf_iterator<char> i1{s}, i2{s};
    std::cout << "i1 returns '" << *i1 << "'\n"
                 "i2 returns '" << *i2 << "'\n";
    ++i1;
    std::cout << "after incrementing i1, but not i2:\n"
                 "i1 returns '" << *i1 << "'\n"
                 "i2 returns '" << *i2 << "'\n";
    ++i2;
    std::cout << "after incrementing i2, but not i1:\n"
                 "i1 returns '" << *i1 << "'\n"
                 "i2 returns '" << *i2 << "'\n";
}

ss has 12 bytes; it holds "Hello, world"
i1 returns 'a'
i2 returns 'a'
after incrementing i1, but not i2:
i1 returns 'b'
i2 returns 'b'
after incrementing i2, but not i1:
i1 returns 'c'
i2 returns 'c'

缺陷报告

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

参见