名前空間
変種
操作

std::basic_syncbuf

From cppreference.com
< cpp‎ | io
 
C++
コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ
 
入出力ライブラリ
I/Oマニピュレータ
出力関数 (C++23)
C形式I/O
バッファ
(C++23)
(C++98/26*)
basic_syncbuf
(C++20)
ストリーム
抽象化
ファイルI/O
文字列I/O
配列I/O
(C++23)
(C++23)
(C++23)
(C++98/26*)
(C++98/26*)
(C++98/26*)
同期出力
(C++20)
型
エラーカテゴリインターフェース
(C++11)
(C++11)
 
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>

目次

[編集] メンバ型

メンバ型 定義
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 アロケータ
streambuf_type std::basic_streambuf<CharT, Traits>

[編集] メンバ関数

公開メンバ関数

 basic_syncbufオブジェクトを構築する
(public メンバ関数) [編集]
 basic_syncbufオブジェクトを代入する
(public メンバ関数) [編集]
 2つのbasic_syncbufオブジェクトをスワップする
(public メンバ関数) [編集]
 basic_syncbufを破棄し、内部バッファを出力する
(public メンバ関数) [編集]
 内部バッファ全体をラップされたstreambufにアトミックに送信する
(public メンバ関数) [編集]
 ラップされたstreambufポインタを取得する
(public メンバ関数) [編集]
 このbasic_syncbufで使用されるアロケータを取得する
(public メンバ関数) [編集]
 現在のemit-on-syncポリシーを変更する
(public メンバ関数) [編集]

Protected member functions

 現在のemit-on-syncポリシーに応じて、発行するか、保留中のフラッシュを記録する
(public メンバ関数) [編集]

[編集] 非メンバ関数

(C++20)
 std::swap アルゴリズムを特殊化する
(関数テンプレート) [編集]

std::basic_streambuf から継承

メンバ型

メンバ型 定義
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[編集]

メンバ関数

[virtual]
 basic_streambuf オブジェクトを破棄する
(std::basic_streambuf<CharT,Traits> の仮想 public メンバ関数) [編集]
ロケール
 関連するロケールを変更し、imbue() を呼び出す
(std::basic_streambuf<CharT,Traits> の public メンバ関数) [編集]
 関連するロケールのコピーを取得する
(std::basic_streambuf<CharT,Traits> の public メンバ関数) [編集]
位置付け
 setbuf() を呼び出す
(std::basic_streambuf<CharT,Traits> の public メンバ関数) [編集]
 seekoff() を呼び出す
(std::basic_streambuf<CharT,Traits> の public メンバ関数) [編集]
 seekpos() を呼び出す
(std::basic_streambuf<CharT,Traits> の public メンバ関数) [編集]
 sync() を呼び出す
(std::basic_streambuf<CharT,Traits> の public メンバ関数) [編集]
取得領域
 取得領域ですぐに利用可能な文字数を取得する
(std::basic_streambuf<CharT,Traits> の public メンバ関数) [編集]
 入力シーケンスを進め、その後、再度進めずに1文字を読み取る
(std::basic_streambuf<CharT,Traits> の public メンバ関数) [編集]
(C++17 で削除)
 入力シーケンスから1文字を読み込み、シーケンスを進める
(std::basic_streambuf<CharT,Traits> の public メンバ関数) [編集]
 シーケンスを進めずに、入力シーケンスから1文字を読み取る
(std::basic_streambuf<CharT,Traits> の public メンバ関数) [編集]
 xsgetn() を呼び出す
(std::basic_streambuf<CharT,Traits> の public メンバ関数) [編集]
配置領域
 配置領域に1文字を書き込み、次のポインタを進める
(std::basic_streambuf<CharT,Traits> の public メンバ関数) [編集]
 xsputn() を呼び出す
(std::basic_streambuf<CharT,Traits> の public メンバ関数) [編集]
戻し
 1文字を入力シーケンスに戻す
(std::basic_streambuf<CharT,Traits> の public メンバ関数) [編集]
 入力シーケンスの次のポインタを1つ戻す
(std::basic_streambuf<CharT,Traits> の public メンバ関数) [編集]

Protected member functions

 basic_streambuf オブジェクトを構築する
(protected メンバ関数) [編集]
(C++11)
 basic_streambuf オブジェクトを置き換える
(protected メンバ関数) [編集]
(C++11)
 2つの basic_streambuf オブジェクトをスワップする
(protected メンバ関数) [編集]
ロケール
[virtual]
 関連するロケールの変更に対応する
(std::basic_streambuf<CharT,Traits> の仮想 protected メンバ関数) [編集]
位置付け
[virtual]
 許可されていれば、バッファをユーザー定義配列で置き換える
(std::basic_streambuf<CharT,Traits> の仮想 protected メンバ関数) [編集]
[virtual]
 入力シーケンス、出力シーケンス、またはその両方で、相対アドレス指定を使用して次のポインタを再配置する
(std::basic_streambuf<CharT,Traits> の仮想 protected メンバ関数) [編集]
[virtual]
 入力シーケンス、出力シーケンス、またはその両方で、絶対アドレス指定を使用して次のポインタを再配置する
(std::basic_streambuf<CharT,Traits> の仮想 protected メンバ関数) [編集]
[virtual]
 バッファを関連付けられた文字シーケンスと同期する
(std::basic_streambuf<CharT,Traits> の仮想 protected メンバ関数) [編集]
取得領域
[virtual]
 分かっていれば、関連付けられた入力シーケンスで入力に利用可能な文字数を取得する
(std::basic_streambuf<CharT,Traits> の仮想 protected メンバ関数) [編集]
[virtual]
 関連付けられた入力シーケンスから取得領域に文字を読み込む
(std::basic_streambuf<CharT,Traits> の仮想 protected メンバ関数) [編集]
[virtual]
 関連付けられた入力シーケンスから取得領域に文字を読み込み、次のポインタを進める
(std::basic_streambuf<CharT,Traits> の仮想 protected メンバ関数) [編集]
[virtual]
 入力シーケンスから複数の文字を読み込む
(std::basic_streambuf<CharT,Traits> の仮想 protected メンバ関数) [編集]
 取得領域の先頭、現在の文字、および末尾へのポインタを返す
(protected メンバ関数) [編集]
 入力シーケンスの次のポインタを進める
(protected メンバ関数) [編集]
 入力シーケンスの先頭、次、および末尾のポインタを再配置する
(protected メンバ関数) [編集]
配置領域
[virtual]
 出力シーケンスに複数の文字を書き込む
(std::basic_streambuf<CharT,Traits> の仮想 protected メンバ関数) [編集]
[virtual]
 関連付けられた出力シーケンスに、配置領域から文字を書き込む
(std::basic_streambuf<CharT,Traits> の仮想 protected メンバ関数) [編集]
 配置領域の先頭、現在の文字、および末尾へのポインタを返す
(protected メンバ関数) [編集]
 出力シーケンスの次のポインタを進める
(protected メンバ関数) [編集]
 出力シーケンスの先頭、次、および末尾のポインタを再配置する
(protected メンバ関数) [編集]
戻し
[virtual]
 入力シーケンスに1文字を戻す (入力シーケンスを変更する可能性あり)
(std::basic_streambuf<CharT,Traits> の仮想 protected メンバ関数) [編集]

[編集] 備考

機能テストマクロ 値 規格 機能
__cpp_lib_syncbuf 201803L (C++20) 同期バッファ付きostream (std::syncbuf, std::osyncstream) およびマニピュレータ
「https://ja.cppreference.dev/mwiki/index.php?title=cpp/io/basic_syncbuf&oldid=148138」から取得
English 日本語 中文(简体) 中文(繁體)