名前空間
変種
操作

std::basic_spanbuf

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
バッファ
basic_spanbuf
(C++23)
(C++98/26*)
(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_spanbuf
公開メンバ関数
(C++23)
(C++23)
(C++23)
(C++23)
Protected member functions
(C++23)
(C++23)
(C++23)
非メンバ関数
(C++23)
 
ヘッダ <spanstream> で定義
template<

    class CharT,
    class Traits = std::char_traits<CharT>
> class basic_spanbuf

    : public std::basic_streambuf<CharT, Traits>
 (C++23から)

std::basic_spanbufは、メモリ常駐の任意の文字シーケンスを管理するstd::basic_streambufです。このシーケンスは、std::span<CharT>のインスタンスから初期化したり、またはそのインスタンスとして提供したりできます。

std::basic_spanbufは固定バッファに対してI/O操作を行うため、基になるバッファが枯渇しても新しいバッファを取得しようとはしません。

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

ヘッダ <spanstream> で定義
型 定義
std::spanbuf std::basic_spanbuf<char>
std::wspanbuf std::basic_spanbuf<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[編集]

[編集] データメンバ

メンバ名 定義
mod (private) オープンモードを記録するstd::ios_base::openmode。
(説明用のメンバオブジェクト*)
buf (private) 基になるバッファを参照するstd::span<CharT>。
(説明用のメンバオブジェクト*)

[編集] メンバ関数

公開メンバ関数
 basic_spanbufオブジェクトを構築します
(公開メンバ関数) [編集]
(デストラクタ)
[virtual]
 basic_spanbufオブジェクトを破棄します
(仮想 public メンバ関数)
basic_spanbufオブジェクトを代入します
(公開メンバ関数) [編集]
 2つのbasic_spanbufオブジェクトを交換します
(公開メンバ関数) [編集]
 モードに従って基になるバッファを取得または初期化します
(公開メンバ関数) [編集]
Protected member functions
[virtual]
 制御文字シーケンスを配列で置き換えようとする
(仮想保護メンバ関数) [編集]
[virtual]
 入力シーケンス、出力シーケンス、またはその両方で、相対アドレス指定を使用して次のポインタを再配置する
(仮想保護メンバ関数) [編集]
[virtual]
 入力シーケンス、出力シーケンス、またはその両方で、絶対アドレス指定を使用して次のポインタを再配置する
(仮想保護メンバ関数) [編集]

[編集] 非メンバ関数

(C++23)
 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 メンバ関数) [編集]

[編集] 注釈

std::basic_spanbufは、基になるバッファを所有しません。

プログラマは、std::basic_spanbufオブジェクトによって使用されている間、基になるバッファがそのライフタイム内にあることを保証する責任があります。複数のスレッドが異なるstd::basic_spanbufオブジェクトを介して同じ基になるバッファを操作する場合、追加の同期が必要になることがあります。

機能テストマクロ 値 規格 機能
__cpp_lib_spanstream 202106L (C++23) std::spanbuf、std::spanstream

[編集] 関連項目

 生の文字列デバイスを実装する
(クラステンプレート) [編集]
(C++98で非推奨)(C++26で削除)
 生の文字配列デバイスを実装する
(クラス) [編集]
"https://ja.cppreference.dev/mwiki/index.php?title=cpp/io/basic_spanbuf&oldid=177360" から取得
English 日本語 中文(简体) 中文(繁體)