Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
Miscellaneous
IOstream Library
manipulators
classes:
filebuf
fstream
ifstream
ios
iostream
ios_base
istream
istringstream
ofstream
ostream
ostringstream
streambuf
stringbuf
stringstream
objects:
cerr
cin
clog
cout
types:
fpos
streamoff
streampos
streamsize
istringstream
istringstream::istringstream
member functions:
istringstream::rdbuf
istringstream::str


istringstream::str

public member function
string str ( ) const;
void str ( const string & s );

Get/set the string content

The first version returns a copy of the string object currently associated with the string stream buffer.

The second syntax copies the content of string s to the string object associated with the string stream buffer.

The function effectivelly calls rdbuf()->str().

Notice that setting a new string does not clear the error flags currently set in the stream object unless the member function clear is explicitly called.

Parameters

s
String object whose content is to be copied to the string stream buffer.

Return Value

The second version returns a copy of the string object currently associated with 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
22
23
 
// istringstream::str
#include <iostream>
#include <sstream>
#include <string>
using namespace std;
int main () {
  int val,n;
  istringstream iss;
  string strvalues = "32 240 2 1450";
  iss.str (strvalues);
  for (n=0; n<4; n++)
  {
    iss >> val;
    cout << val+1 << endl;
  }
  return 0;
}


This example uses the str member to copy the content of the string object strvalues to the internal associated string object in the istringstream iss.

Basic template member declaration

( basic_istringstream<charT,traits,Allocator> )
1
2
 
basic_string<charT,traits,Allocator> str () const;
void str (const basic_string<charT,traits,Allocator> & s );


See also

istringstream::istringstream Construct an object and optionally initialize its content (constructor member)