public member function
<sstream>
std::stringstream::str
string str() const; void str (const string& s);
Get/set content
The first form
(1) returns a
string object with a copy of the current contents of the stream.
The second form (2) sets s as the contents of the stream, discarding any previous contents. The object preserves its open mode: if this includes ios_base::ate, the writing position is moved to the end of the new sequence.
Internally, the function calls the str member of its internal string buffer object.
Parameters
-
s
- A string object, whose content is copied.
Return Value
For (1), a string object with a copy of the current contents in the stream buffer.Example
| |
Example string |
Data races
Accesses (1) or modifies (2) the stringstream object.Concurrent access to the same object may cause data races.
Exception safety
Basic guarantee: if an exception is thrown, the object is in a valid state.See also
-
stringstream::stringstream
- Construct object (public member function )
-
stringbuf::str
- Get/set the string content (public member function )