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

基になる文字列を取得および設定します。

以下の説明において、 buf および mode は exposition-only data members であり、 * this のメンバです。

書き込み用に開かれたバッファ内のメンバー文字シーケンスは、効率化のためにオーバーアロケーションされる場合があります。その場合、 初期化済み文字 のみが返されます：これらの文字は、コンストラクタの文字列引数、 str() のセッターオーバーロードの最新の呼び出しにおける文字列引数、または書き込み操作から取得されたものです。オーバーアロケーションを使用する典型的な実装では、バッファの初期化済み部分の終端を追跡するためのハイウォーターマークポインタが維持され、このオーバーロードは pbase() からハイウォーターマークポインタまでの文字を返します。

パラメータ

戻り値

注記

この関数は通常、 std::basic_istringstream::str() 、 std::basic_ostringstream::str() または std::basic_stringstream::str() を通じてアクセスされます。

例

#include <iostream>
#include <sstream>
int main()
{
    int n;
    std::istringstream in;  // could also use in("1 2")
    in.rdbuf()->str("1 2"); // set the get area
    in >> n;
    std::cout << "after reading the first int from \"1 2\", the int is " 
              << n << ", str() = \"" << in.rdbuf()->str() << "\"\n"; // or in.str()
    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); // C++11
    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"

不具合報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

関連項目