Namespaces
Variants

std:: basic_stringstream

From cppreference.net
< cpp ‎ | io
ヘッダーで定義 <sstream>
template <

class CharT,
class Traits = std:: char_traits < CharT > ,
class Allocator = std:: allocator < CharT >
> class basic_stringstream

: public basic_iostream < CharT, Traits > ;

クラステンプレート std::basic_stringstream は、文字列ベースのストリームに対する入出力操作を実装します。これは実質的に std::basic_string のインスタンスを格納し、それに対する入出力操作を実行します。

低レベルでは、このクラスは本質的に std::basic_stringbuf の生文字列デバイス実装を std::basic_iostream の高レベルインターフェースにラップします。 std::basic_stringbuf 独自のメンバーに対する完全なインターフェースが提供されます。

cpp/io/ios base cpp/io/basic ios cpp/io/basic istream cpp/io/basic ostream cpp/io/basic iostream std-basic stringstream-inheritance.svg

継承図

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

ヘッダーで定義 <sstream>
定義
std::stringstream std :: basic_stringstream < char >
std::wstringstream std :: basic_stringstream < 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 Allocator

説明専用メンバ

名前 定義
sb 基盤となるバッファとして使用される std:: basic_stringbuf < CharT, Traits, Allocator >
( 説明専用メンバーオブジェクト* )

メンバー関数

文字列ストリームを構築する
(公開メンバ関数)
(C++11)
文字列ストリームをムーブする
(公開メンバ関数)
(C++11)
2つの文字列ストリームを交換する
(公開メンバ関数)
基となる生文字列デバイスオブジェクトを返す
(公開メンバ関数)
文字列操作
基となる文字列デバイスオブジェクトの内容を取得または設定する
(公開メンバ関数)
(C++20)
基となる文字列デバイスオブジェクトの内容に対するビューを取得する
(公開メンバ関数)

非メンバー関数

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

std::basic_istream から継承

メンバ関数

書式付き入力
書式付きデータを抽出
( std::basic_istream<CharT,Traits> の公開メンバ関数)
書式なし入力
文字を抽出
( std::basic_istream<CharT,Traits> の公開メンバ関数)
次の文字を抽出せずに読み取る
( std::basic_istream<CharT,Traits> の公開メンバ関数)
文字を抽出解除
( std::basic_istream<CharT,Traits> の公開メンバ関数)
入力ストリームに文字を戻す
( std::basic_istream<CharT,Traits> の公開メンバ関数)
指定された文字が見つかるまで文字を抽出
( std::basic_istream<CharT,Traits> の公開メンバ関数)
指定された文字が見つかるまで文字を抽出して破棄
( std::basic_istream<CharT,Traits> の公開メンバ関数)
文字ブロックを抽出
( std::basic_istream<CharT,Traits> の公開メンバ関数)
利用可能な文字ブロックを抽出
( std::basic_istream<CharT,Traits> の公開メンバ関数)
最後の書式なし入力操作で抽出された文字数を返す
( std::basic_istream<CharT,Traits> の公開メンバ関数)
位置指定
入力位置指示子を返す
( std::basic_istream<CharT,Traits> の公開メンバ関数)
入力位置指示子を設定
( std::basic_istream<CharT,Traits> の公開メンバ関数)
その他
基盤となる記憶装置と同期
( std::basic_istream<CharT,Traits> の公開メンバ関数)

メンバクラス

ストリームの入力操作準備の基本ロジックを実装
( std::basic_istream<CharT,Traits> の公開メンバクラス)

std:: basic_ostream から継承

メンバ関数

書式付き出力
書式付きデータを挿入
( std::basic_ostream<CharT,Traits> の公開メンバ関数)
書式なし出力
文字を挿入
( std::basic_ostream<CharT,Traits> の公開メンバ関数)
文字ブロックを挿入
( std::basic_ostream<CharT,Traits> の公開メンバ関数)
位置指定
出力位置指示子を返す
( std::basic_ostream<CharT,Traits> の公開メンバ関数)
出力位置指示子を設定
( std::basic_ostream<CharT,Traits> の公開メンバ関数)
その他
基盤となる記憶装置と同期
( std::basic_ostream<CharT,Traits> の公開メンバ関数)

メンバクラス

ストリームの出力操作準備の基本ロジックを実装
( std::basic_ostream<CharT,Traits> の公開メンバクラス)

std:: basic_ios から継承

メンバ型

メンバ型 定義
char_type CharT
traits_type Traits
int_type Traits::int_type
pos_type Traits::pos_type
off_type Traits::off_type

メンバ関数

状態関数
エラーが発生しておらず、I/O操作が利用可能かチェック
( std::basic_ios<CharT,Traits> の公開メンバ関数)
ファイル終端に達したかチェック
( std::basic_ios<CharT,Traits> の公開メンバ関数)
エラーが発生したかチェック
( std::basic_ios<CharT,Traits> の公開メンバ関数)
回復不可能なエラーが発生したかチェック
( std::basic_ios<CharT,Traits> の公開メンバ関数)
エラーが発生したかチェック( fail() の同義語)
( std::basic_ios<CharT,Traits> の公開メンバ関数)
エラーが発生していないかチェック( ! fail() の同義語)
( std::basic_ios<CharT,Traits> の公開メンバ関数)
状態フラグを返す
( std::basic_ios<CharT,Traits> の公開メンバ関数)
状態フラグを設定
( std::basic_ios<CharT,Traits> の公開メンバ関数)
状態フラグを変更
( std::basic_ios<CharT,Traits> の公開メンバ関数)
書式設定
書式情報をコピー
( std::basic_ios<CharT,Traits> の公開メンバ関数)
埋め文字を管理
( std::basic_ios<CharT,Traits> の公開メンバ関数)
その他
例外マスクを管理
( std::basic_ios<CharT,Traits> の公開メンバ関数)
ロケールを設定
( std::basic_ios<CharT,Traits> の公開メンバ関数)
関連付けられたストリームバッファを管理
( std::basic_ios<CharT,Traits> の公開メンバ関数)
関連付けられたストリームを管理
( std::basic_ios<CharT,Traits> の公開メンバ関数)
文字をナロー化
( std::basic_ios<CharT,Traits> の公開メンバ関数)
文字をワイド化
( std::basic_ios<CharT,Traits> の公開メンバ関数)

std:: ios_base から継承

メンバー関数

フォーマット
フォーマットフラグを管理する
( std::ios_base のpublicメンバー関数)
特定のフォーマットフラグを設定する
( std::ios_base のpublicメンバー関数)
特定のフォーマットフラグをクリアする
( std::ios_base のpublicメンバー関数)
浮動小数点演算の10進精度を管理する
( std::ios_base のpublicメンバー関数)
フィールド幅を管理する
( std::ios_base のpublicメンバー関数)
ロケール
ロケールを設定する
( std::ios_base のpublicメンバー関数)
現在のロケールを返す
( std::ios_base のpublicメンバー関数)
内部拡張可能配列
[static]
pword() および iword() のインデックスとして使用するのに安全な、プログラム全体で一意の整数を返す
( std::ios_base のpublic staticメンバー関数)
必要に応じてプライベートストレージをリサイズし、指定されたインデックスの long 要素にアクセスする
( std::ios_base のpublicメンバー関数)
必要に応じてプライベートストレージをリサイズし、指定されたインデックスの void * 要素にアクセスする
( std::ios_base のpublicメンバー関数)
その他
イベントコールバック関数を登録する
( std::ios_base のpublicメンバー関数)
C++とCのI/Oライブラリが相互運用可能かどうかを設定する
( std::ios_base のpublic staticメンバー関数)
メンバークラス
ストリーム例外
( std::ios_base のpublicメンバークラス)
標準ストリームオブジェクトを初期化する
( std::ios_base のpublicメンバークラス)

メンバー型と定数

説明
ストリームオープンモード型

以下の定数も定義されています:

定数 説明
app 各書き込み前にストリームの終端へシーク
binary バイナリモード でオープン
in 読み取り用にオープン
out 書き込み用にオープン
trunc オープン時にストリームの内容を破棄
ate オープン直後にストリームの終端へシーク
noreplace (C++23) 排他モードでオープン

(typedef)
書式フラグ型

以下の定数も定義されています:

定数 説明
dec 整数I/Oに10進基数を使用:参照 std::dec
oct 整数I/Oに8進基数を使用:参照 std::oct
hex 整数I/Oに16進基数を使用:参照 std::hex
basefield dec | oct | hex 。マスク操作に有用
left 左揃え(右側に埋め文字を追加):参照 std::left
right 右揃え(左側に埋め文字を追加):参照 std::right
internal 内部揃え(内部指定点に埋め文字を追加):参照 std::internal
adjustfield left | right | internal 。マスク操作に有用
scientific 浮動小数点型を指数表記で生成、または fixed と組み合わせた場合は16進表記:参照 std::scientific
fixed 浮動小数点型を固定小数点表記で生成、または scientific と組み合わせた場合は16進表記:参照 std::fixed
floatfield scientific | fixed 。マスク操作に有用
boolalpha bool 型を英数字形式で挿入および抽出:参照 std::boolalpha
showbase 整数出力で数値基数を示す接頭辞を生成、通貨I/Oで通貨指示子を要求:参照 std::showbase
showpoint 浮動小数点数出力で無条件に小数点文字を生成:参照 std::showpoint
showpos 非負数値出力で + 文字を生成:参照 std::showpos
skipws 特定の入力操作前に先頭の空白をスキップ:参照 std::skipws
unitbuf 各出力操作後に出力をフラッシュ:参照 std::unitbuf
uppercase 特定の出力操作で特定の小文字を対応する大文字に置換:参照 std::uppercase

(typedef)
ストリームの状態を表す型

以下の定数も定義されています:

定数 説明
goodbit エラーなし
badbit 回復不可能なストリームエラー
failbit 入出力操作の失敗(書式化または抽出エラー)
eofbit 関連付けられた入力シーケンスがファイルの終端に到達

(typedef)
シーク方向の型

以下の定数も定義されています:

定数 説明
beg ストリームの先頭
end ストリームの末尾
cur ストリーム位置指示子の現在位置

(typedef)
イベント型を指定
(列挙型)
コールバック関数型
(typedef)