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
ostringstream
ostringstream::ostringstream
member functions:
ostringstream::rdbuf
ostringstream::str


ostringstream::ostringstream

constructor member
explicit ostringstream ( openmode which = ios_base::out );
explicit ostringstream ( const string & str, openmode which = ios_base::out );

Construct an object and optionally initialize its content

Constructs an object of class ostringstream including the initialization of the associated stringbuf object and the call to its base class's constructor with the initialized stringbuf object as constructor parameter.

Additionally, in case that the second constructor version is used, the stream's buffer is initialized with the content of the string object str as if a call to member str.

Parameters

which
Bitmask with the requested i/o mode for the string buffer. This is an object of type ios_base::openmode. It generally consists of a combination of one or more the following flags (which are member constants):
flag valueopening mode
app(append) Set the stream's position indicator to the end of the stream before each output operation.
ate(at end) Set the stream's position indicator to the end of the stream on opening.
binary(binary) Consider stream as binary rather than text.
in(input) Allow input operations on the stream.
out(output) Allow output operations on the stream.
trunc(truncate) Any current content is discarded, assuming a length of zero on opening.
str
string object to be copied as the initial value for the internal buffer string.

Return Value

none

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// using ostringstream constructors.
#include <iostream>
#include <sstream>
using namespace std;
int main () {
  ostringstream oss (ostringstream::out);
  oss << "This is a test\n";
  cout << oss.str();
  return 0;
}


Basic template member declaration

( basic_ostringstream<charT,traits,Allocator> )
1
2
3
explicit basic_ostringstream ( openmode which = ios_base::out );
explicit basic_ostringstream ( const basic_string<charT,traits,Allocator> * str,
                               openmode which = ios_base::out );


See also