std::basic_streambuf

クラス basic_streambuf は文字シーケンスの入出力を制御します。 以下のものを持ち、それらへのアクセスを提供します。

1. 制御された文字シーケンス (バッファとも言います)。 入力操作をバッファリングするのための入力シーケンス (get 領域とも言います) または出力操作をバッファリングするための出力シーケンス (put 領域とも言います) またはその両方を持つかもしれません。
2. 紐付けられた文字シーケンス (入力に対しては ソース、出力に対しては シンクとも言います)。 OS の API を通してアクセスされるエンティティ (ファイル、 TCP ソケット、シリアルポート、その他のキャラクタデバイス) かもしれませんし、文字のソースまたはシンクとして解釈可能なオブジェクト (std::vector、配列、文字列リテラル) かもしれません。

入出力ストリームオブジェクト std::basic_istream、 std::basic_ostream およびそれらから派生するすべてのオブジェクト (std::ofstream、 std::stringstream など) は完全に std::basic_streambuf の観点から実装されます。

制御された文字シーケンスは CharT の配列であり、常に、紐付けられている文字シーケンスの部分シーケンス (または「窓」) を表します。 その状態は3つのポインタで記述されます。

1. 先頭ポインタ — 常にバッファの最も低い要素を指します。
2. 次ポインタ — 読み書きの次の候補となる要素を指します。
3. 終端ポインタ — バッファの終端���指します。

basic_streambuf は入力 (この場合、先頭、次、終端ポインタによって記述されるバッファは get 領域と呼ばれます)、出力 (put 領域)、または入力と出力を同時にサポートするかもしれません。 後者の場合、6つのポインタが追跡されます。 それらはすべて同じ文字配列の、または2つの別々の配列の要素を指すかもしれません。

put 領域の次ポインタが終端ポインタより小さい場合は、書き込み位置が利用可能です。 次ポインタは、逆参照し、代入することができます。

get 領域の次ポインタが終端ポインタより小さい場合は、読み込み位置が利用可能です。 次ポインタは、逆参照し、読み込むことができます。

get 領域の次ポインタが先頭ポインタより大きい場合は、 putback 位置が利用可能であり、次ポインタは、文字を get 領域に戻すために、デクリメントし、逆参照し、代入することができます。

制御されたシーケンス内の文字表現およびエンコーディングは、紐付けられているシーケンス内の文字表現と異なるかもしれません。 その場合、一般的には変換を行うためにロケールの std::codecvt ファセットが使用されます。 よくある例は std::wfstream オブジェクトを通してアクセスする UTF-8 (または他のマルチバイトエンコーディング) のファイルです。 制御されたシーケンスは wchar_t 文字から構成されますが、紐付けられているシーケンスはバイトから構成されます。

std::basic_streambuf 基底クラスの一般的な実装は、6つの CharT* ポインタと std::locale のコピーだけをデータメンバとして保持します。 さらに、処理系はロケールファセットのキャッシュされたコピーを保持するかもしれません (imbue() が呼ばれると無効化されます)。 std::basic_filebuf や std::basic_stringbuf などの具象クラスは std::basic_streambuf から派生します。

2つの便利な typedef が標準ライブラリによって提供されます。

[編集] メンバ型

[編集] メンバ関数

[編集] 関連項目