C++

Reference

<sstream>

istringstream

public member function
<sstream>

std::istringstream::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 str 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

str
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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
 
// istringstream::str #include <string> // std::string #include <iostream> // std::cout #include <sstream> // std::istringstream int main () { std::istringstream iss; std::string strvalues = "32 240 2 1450"; iss.str (strvalues); for (int n=0; n<4; n++) { int val; iss >> val; std::cout << val << '\n'; } std::cout << "Finished writing the numbers in: "; std::cout << iss.str() << '\n'; return 0; }
 

32 240 2 1450 Finished writing the numbers in: 32 240 2 1450


Data races

Accesses (1) or modifies (2) the istringstream 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

istringstream::istringstream
Construct object (public member function)
stringbuf::str
Get/set the string content (public member function)