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 issue 659の解決により、 LWG issue 659 で operator - > が導入されました。 std::istreambuf_iterator i が与えられた場合、式 ( * i ) . m と i - > m が同じ効果を持つことが期待されます。

しかし、この解決策はその動作の正式な仕様を提供していません。そのため、実装によって異なり、 nullptr を返す、一時オブジェクトのアドレスを返す、あるいはメンバを全く提供しないなどの実装があります。その意図された動作を達成することはほぼ不可能であり、 LWG issue 2790 の解決によって削除されました。

LWG issue 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++規格に対して遡及的に適用されました。

関連項目