std::basic_ostringstream<CharT,Traits,Allocator>::str

 

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_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

ストリーム

抽象化

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

ファイルI/O

basic_ifstream

basic_ofstream

basic_fstream

文字列I/O

basic_istringstream

basic_ostringstream

basic_stringstream

配列I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同期出力

basic_osyncstream (C++20)

型

streamoff

streamsize

fpos

エラーカテゴリインターフェース

iostream_category (C++11)

io_errc (C++11)

 

std::basic_ostringstream

メンバ関数

basic_ostringstream::basic_ostringstream

basic_ostringstream::operator=

basic_ostringstream::swap (C++11)

basic_ostringstream::rdbuf

文字列操作

basic_ostringstream::str

basic_ostringstream::view (C++20)

非メンバ関数

swap(std::basic_ostringstream) (C++11)

 

	(1)
std::basic_string<CharT, Traits, Allocator> str() const;			(C++20まで)
std::basic_string<CharT, Traits, Allocator> str() const&;			(C++20以降)
template< class SAlloc > std::basic_string<CharT, Traits, SAlloc> str( const SAlloc& a ) const;		(2)	(C++20以降)
std::basic_string<CharT, Traits, Allocator> str() &&;		(3)	(C++20以降)
void str( const std::basic_string<CharT, Traits, Allocator>& s );		(4)
template< class SAlloc > void str( const std::basic_string<CharT, Traits, SAlloc>& s );		(5)	(C++20以降)
void str( std::basic_string<CharT, Traits, Allocator>&& s );		(6)	(C++20以降)
template< class StringViewLike > void str( const StringViewLike& t );		(7)	(C++26以降)

基底となる文字列オブジェクトの内容を管理します。

1) 基底となる文字列のコピーを返します。return rdbuf()->str(); と同等です。

2) アロケータ a を使用して、基底となる文字列のコピーを返します。return rdbuf()->str(a); と同等です。

3) 基底となる文字列からムーブ構築された文字列を返します。return std::move(*rdbuf()).str(); と同等です。

4,5) 基底となる文字列の内容を置き換えます。rdbuf()->str(s); と同等です。

6) 基底となる文字列の内容を置き換えます。rdbuf()->str(std::move(s)); と同等です。

7) 基底となる文字列の内容を置き換えます。rdbuf()->str(t); と同等です。

このオーバーロードは、is_convertible_v<const T&, basic_string_view<charT, traits>> が true の場合にのみ、オーバーロード解決に参加します。

パラメータ

s	-	基底となる文字列の新しい内容
t	-	基底となる文字列の新しい内容として使用するオブジェクト（std::basic_string_view に変換可能）
a	-	返される文字列を構築するために使用されるアロケータ

戻り値

1,2) 基底となる文字列オブジェクトのコピー。

3) 基底となる文字列オブジェクトからムーブ構築された文字列。

4-7) (なし)

注記

str によって返される基底となる文字列のコピーは一時オブジェクトであり、式が終わると破棄されるため、str()() の結果に対して直接 auto *ptr = out.str().c_str(); のように c_str() を呼び出すと、ダングリングポインタになります。

機能テストマクロ	値	規格	機能
__cpp_lib_sstream_from_string_view	202306L	(C++26)	std::stringstream と std::string_view との連携、(7)

例

このコードを実行

#include <iostream>
#include <sstream>
 
int main()
{
    int n;
 
    std::istringstream in; // could also use in("1 2")
    in.str("1 2");
    in >> n;
    std::cout << "After reading the first int from \"1 2\", the int is "
              << n << ", str() = \"" << in.str() << "\"\n";
 
    std::ostringstream out("1 2");
    out << 3;
    std::cout << "After writing the int '3' to output stream \"1 2\""
              << ", str() = \"" << out.str() << "\"\n";
 
    std::ostringstream ate("1 2", std::ios_base::ate);
    ate << 3;
    std::cout << "After writing the int '3' to append stream \"1 2\""
              << ", str() = \"" << ate.str() << "\"\n";
}

出力

After reading the first int from "1 2", the int is 1, str() = "1 2"
After writing the int '3' to output stream "1 2", str() = "3 2"
After writing the int '3' to append stream "1 2", str() = "1 23"

関連項目

rdbuf	基礎となる生文字列デバイスオブジェクトを返す (public メンバ関数)
str	関連する文字文字列のコピーを置き換える、または取得する (std::basic_stringbuf<CharT,Traits,Allocator> の public メンバ関数)