Gets and sets the underlying string.

In the descriptions below,buf andmode areexposition-only data members of*this.

The member character sequence in a buffer open for writing can be over-allocated for efficiency purposes. In that case, only theinitialized characters are returned: these characters are the ones that were obtained from the string argument of the constructor, the string argument of the most recent call to a setter overload ofstr(), or from a write operation. A typical implementation that uses over-allocation maintains a high-watermark pointer to track the end of the initialized part of the buffer and this overload returns the characters frompbase() to the high-watermark pointer.

[edit]Parameters

[edit]Return value

[edit]Notes

This function is typically accessed throughstd::basic_istringstream::str(),std::basic_ostringstream::str(), orstd::basic_stringstream::str().

[edit]Example

#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"

[edit]Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

[edit]See also

• In other languages

• Deutsch
• Español
• Français
• Italiano
• 日本語
• Português
• Русский
• 中文