Namespaces
Variants

std::ostreambuf_iterator

ja.cppreference.net より
 
 
イテレータライブラリ
イテレータコンセプト
イテレータプリミティブ
アルゴリズムのコンセプトとユーティリティ
間接呼び出し可能コンセプト
共通アルゴリズム要件
(C++20)
(C++20)
(C++20)
ユーティリティ
(C++20)
イテレータアダプタ
範囲アクセス
(C++11)(C++14)
(C++14)(C++14)  
(C++11)(C++14)
(C++14)(C++14)  
(C++17)(C++20)
(C++17)
(C++17)
 
 
ヘッダ <iterator>
template< class CharT, class Traits = std::char_traits<CharT> >
class ostreambuf_iterator
    : public std::iterator<std::output_iterator_tag, void, void, void, void>
で定義されます (C++17まで)
template< class CharT, class Traits = std::char_traits<CharT> >
class ostreambuf_iterator;
(C++17以降)

std::ostreambuf_iterator は、構築時に指定された std::basic_streambuf オブジェクトに連続する文字を書き込む、シングルパスの LegacyOutputIterator です。実際の書き込み操作は、イテレータ(間接参照されているかどうかにかかわらず)に代入が行われたときに実行されます。std::ostreambuf_iterator のインクリメントは何もしません (no-op)。

典型的な実装では、std::ostreambuf_iterator の唯一のデータメンバは、関連付けられた std::basic_streambuf へのポインタと、ファイル終端 (end-of-file) 条件に達したかどうかを示す真理値フラグです。

メンバー型

メンバ型 定義
iterator_category std:: output_iterator_tag
value_type void
difference_type

void

(C++20まで)

std::ptrdiff_t

(C++20以降)
pointer void
reference void
char_type CharT
traits_type Traits
streambuf_type std:: basic_streambuf < CharT, Traits >
ostream_type std:: basic_ostream < CharT, Traits >

メンバ型 iterator_category , value_type , difference_type , pointer および reference は、 std:: iterator < std:: output_iterator_tag , void , void , void , void > からの継承によって取得することが要求される。

(C++17まで)

メンバー関数

新しい ostreambuf_iterator を構築する
(public member function)
(destructor)
(implicitly declared)
ostreambuf_iterator を破棄する
(public member function)
文字を関連付けられた出力シーケンスに書き込む
(public member function)
何も行わない
(public member function)
何も行わない
(public member function)
出力が失敗したかどうかをテストする
(public member function)

例

#include <algorithm>
#include <iostream>
#include <iterator>
#include <string>
int main()
{
    std::string s = "This is an example\n";
    std::copy(s.begin(), s.end(), std::ostreambuf_iterator<char>(std::cout));
}

出力:

This is an example

関連項目

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