std::istreambuf_iterator

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

イテレータライブラリ

イテレータコンセプト
indirectly_readable (C++20) indirectly_writable (C++20) weakly_incrementable (C++20) incrementable (C++20) input_or_output_iterator (C++20) sentinel_for (C++20) sized_sentinel_for (C++20)	input_iterator (C++20) output_iterator (C++20) forward_iterator (C++20) bidirectional_iterator (C++20) random_access_iterator (C++20) contiguous_iterator (C++20)
イテレータプリミティブ
iterator_traits input_iterator_tagoutput_iterator_tagforward_iterator_tagbidirectional_iterator_tagrandom_access_iterator_tagcontiguous_iterator_tag (C++20) iterator (C++17で非推奨)	incrementable_traits (C++20) indirectly_readable_traits (C++20) iter_value_titer_difference_titer_reference_titer_rvalue_reference_titer_common_reference_t (C++20)(C++20)(C++20)(C++20)(C++20)
アルゴリズムのコンセプトとユーティリティ
間接呼び出し可能コンセプト
indirectly_unary_invocableindirectly_regular_unary_invocable (C++20)(C++20) indirect_unary_predicate (C++20)	indirect_binary_predicate (C++20) indirect_equivalence_relation (C++20) indirect_strict_weak_order (C++20)
共通アルゴリズム要件
indirectly_movable (C++20) indirectly_movable_storable (C++20) indirectly_copyable (C++20) indirectly_copyable_storable (C++20)	indirectly_swappable (C++20) indirectly_comparable (C++20) permutable (C++20) mergeable (C++20) sortable (C++20)
ユーティリティ
indirect_result_t	projected
イテレータアダプタ
reverse_iterator move_iterator (C++11) move_sentinel (C++20) common_iterator (C++20) counted_iterator (C++20) back_insert_iterator front_insert_iterator insert_iterator	make_reverse_iterator (C++14) make_move_iterator (C++11) default_sentinel_tdefault_sentinel (C++20)(C++20) unreachable_sentinel_tunreachable_sentinel (C++20)(C++20) back_inserter front_inserter inserter
ストリームイテレータ
istream_iterator ostream_iterator	istreambuf_iterator ostreambuf_iterator
イテレータのカスタマイゼーションポイント
ranges::iter_move (C++20)
ranges::iter_swap (C++20)
イテレータ操作
advance distance prev (C++11) next (C++11)	ranges::advance (C++20) ranges::distance (C++20) ranges::prev (C++20) ranges::next (C++20)
範囲アクセス
begincbegin (C++11)(C++14) endcend (C++11)(C++14) sizessize (C++17)(C++20)	rbegincrbegin (C++14)(C++14) rendcrend (C++14)(C++14) empty (C++17) data (C++17)

 

std::istreambuf_iterator

メンバ関数

istreambuf_iterator::istreambuf_iterator

istreambuf_iterator::operator*istreambuf_iterator::operator-> (C++11)(C++17未満)

istreambuf_iterator::operator++istreambuf_iterator::operator++(int)

istreambuf_iterator::equal

非メンバ関数

operator==operator!= (C++20未満)

 

<tbody> </tbody> <tbody class="t-dcl-rev "> </tbody><tbody> </tbody>

ヘッダ <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, usually CharT* */, CharT >		(C++17未満)
template< class CharT, class Traits = std::char_traits<CharT> > class istreambuf_iterator;		(C++17以上)

std::istreambuf_iterator は指定された std::basic_streambuf オブジェクトから連続する文字を読み込むシングルパスの入力イテレータです。

デフォルト構築された std::istreambuf_iterator はストリーム終端イテレータと言います。 有効な std::istreambuf_iterator が、ベースとなるストリームの終端に達すると、ストリーム終端イテレータと等しくなります。 それ以降の逆参照やインクリメントは未定義動作を発生させます。

std::istreambuf_iterator はトリビアルなコピーコンストラクタ、 constexpr デフォルトコンストラクタ、トリビアルなデストラクタを持ちます。

メンバ型

メンバ型	定義
iterator_category	std::input_iterator_tag
value_type	CharT
difference_type	Traits::off_type
pointer	/* unspecified, usually CharT* */
reference	CharT
char_type	CharT
traits_type	Traits
int_type	typename traits::int_type
streambuf_type	std::basic_streambuf<CharT, Traits>
istream_type	std::basic_istream<CharT, Traits>
/* proxy */	処理系定義のクラス型。 名前 proxy は説明専用です。 proxy オブジェクトは char_type の文字と streambuf_type* のポインタを保持します。 proxy オブジェクトを operator* で逆参照すると格納されている文字を返します。

メンバ型 iterator_category、 value_type、 difference_type、 pointer および reference は std::iterator<std::input_iterator_tag, CharT, Traits::off_type, /* unspecified, usually CharT* */, CharT> から継承することによって取得することが要求されます。

(C++17未満)

メンバ関数

コンストラクタ	新しい istreambuf_iterator を構築します (パブリックメンバ関数)
デストラクタ (暗黙に宣言)	istreambuf_iterator を破棄します (パブリックメンバ関数)
operator*operator-> (C++11以上)(C++17未満)	現在の文字のコピーを取得します CharT がメンバを持つ場合、現在の文字のメンバにアクセスします (パブリックメンバ関数)
operator++operator++(int)	イテレータを進めます (パブリックメンバ関数)
equal	両方の istreambuf_iterator がストリーム終端または両方が有効であるかどうかを調べます (パブリックメンバ関数)

非メンバ関数

operator==operator!= (C++20で削除)

2つの istreambuf_iterator を比較します (関数テンプレート)

例

Run this code

#include <vector>
#include <sstream>
#include <iostream>
#include <iterator>

int main()
{
    // 一般的なユースケース: イテレータの組として表された入力ストリーム。
    std::istringstream in("Hello, world");
    std::vector<char> v( (std::istreambuf_iterator<char>(in)),
                          std::istreambuf_iterator<char>() );
    std::cout << "v has " << v.size() << " bytes. ";
    v.push_back('\0');
    std::cout << "it holds \"" << &v[0] << "\"\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; // これは *i2 の値を見かけ上 'a' から 'c' にジャンプさせます。
    std::cout << "after incrementing i2, but not i1\n"
              << "i1 returns " << *i1 << '\n'
              << "i2 returns " << *i2 << '\n';

}

出力:

v has 12 bytes. it holds "Hello, world"
i1 returns a
i2 returns a
after incrementing i1, but not i2
i1 returns b
i2 returns a
after incrementing i2, but not i1
i1 returns b
i2 returns c

関連項目

ostreambuf_iterator	std::basic_streambuf に書き込む出力イテレータ (クラステンプレート)
istream_iterator	std::basic_istream から読み込む入力イテレータ (クラステンプレート)