std:: basic_syncbuf

ヘッダーで定義 <syncstream>
template < class CharT, class Traits = std:: char_traits < CharT > , class Allocator = std:: allocator < CharT > > class basic_syncbuf : public std:: basic_streambuf < CharT, Traits >		(C++20以降)

std::basic_syncbuf は、 std::basic_streambuf （構築時にポインタとして提供される）のラッパーです。これは独自の内部バッファに出力を蓄積し、破棄時および明示的に要求されたときにその内容全体をラップされたバッファにアトミックに送信し、連続した文字列として表示されるようにします。同じバッファへの他のすべての出力が（異なる可能性のある） std::basic_syncbuf のインスタンスを通じて行われる限り、データ競合がなく、ラップされたバッファに送信される文字のインターリーブが発生しないことを保証します。

std::basic_syncbuf の典型的な実装は、ラップされた std::basic_streambuf へのポインタ、同期（フラッシュ）時にラップされたバッファに内容を送信するかどうかを示すブールフラグ、同期時に出力しないポリシーの場合の保留中のフラッシュを示すブールフラグ、 Allocator を使用する内部バッファ（例: std::string ）、および同じラップされたストリームバッファにアクセスする複数のスレッド間での出力を同期するために使用されるミューテックスへのポインタ（これらのミューテックスは、 std::basic_streambuf オブジェクトへのポインタをキーとして使用するハッシュマップ内にある場合があります）を保持します。

他のストリームバッファクラスと同様に、 std::basic_syncbuf は通常、対応するストリームである std::osyncstream を通じてのみアクセスされ、直接アクセスされることはありません。

一般的な文字型に対するいくつかのtypedefが提供されています：

定義済みヘッダー <syncstream>
型	定義
std::syncbuf	std :: basic_syncbuf < char >
std::wsyncbuf	std :: basic_syncbuf < wchar_t >

目次 1 メンバ型 2 メンバ関数 3 公開メンバ関数 4 保護メンバ関数 5 非メンバ関数 6 std:: basic_streambuf からの継承 6.1 メンバ型 6.2 メンバ関数 6.2.1 ロケール 6.2.2 位置指定 6.2.3 取得領域 6.2.4 格納領域 6.2.5 プットバック 6.3 保護メンバ関数 6.3.1 ロケール 6.3.2 位置指定 6.3.3 取得領域 6.3.4 格納領域 6.3.5 プットバック 6.4 注記

メンバー型

メンバ型	定義
char_type	CharT
traits_type	Traits ; Traits::char_type が CharT でない場合、プログラムは不適格となる。
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type
allocator_type	Allocator
streambuf_type	std:: basic_streambuf < CharT, Traits >

メンバー関数

公開メンバ関数
(constructor)	basic_syncbuf オブジェクトを構築する (公開メンバ関数)
operator=	basic_syncbuf オブジェクトを代入する (公開メンバ関数)
swap	2つの basic_syncbuf オブジェクトを交換する (公開メンバ関数)
(destructor)	basic_syncbuf を破棄し、内部バッファを出力する (公開メンバ関数)
emit	内部バッファ全体をアトミックにラップされたstreambufに送信する (公開メンバ関数)
get_wrapped	ラップされたstreambufポインタを取得する (公開メンバ関数)
get_allocator	この basic_syncbuf で使用されるアロケータを取得する (公開メンバ関数)
set_emit_on_sync	現在のemit-on-syncポリシーを変更する (公開メンバ関数)
保護メンバ関数
sync	現在のemit-on-syncポリシーに応じて、出力するか保留中のフラッシュを記録する (公開メンバ関数)

非メンバー関数

std::swap (std::basic_syncbuf) (C++20)

std::swap アルゴリズムを特殊化する (関数テンプレート)

注記

機能テスト マクロ	値	標準	機能
__cpp_lib_syncbuf	201803L	(C++20)	同期化バッファ付きostream ( std::syncbuf , std::osyncstream ) とマニピュレータ