cplusplus.com cplusplus.com
cplusplus.com   C++ : Reference : IOstream Library : ostream : ostream
- -
C++
Information
Documentation
Reference
Articles
Sourcecode
Forum
Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
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
ostream
· ostream::ostream
· ostream::~ostream
member classes:
· ostream::sentry
member functions:
· ostream::flush
· ostream::operator<<
· ostream::put
· ostream::seekp
· ostream::tellp
· ostream::write

-

ostream::ostream constructor member
explicit ostream (streambuf * sb);

Construct object

Constructs an object, assigning initial values to the base class by calling the inherited member ios::init with sb as parameter.

Parameters

sb
pointer to a streambuf object, which is set as the associated stream buffer for the object.

Return Value

None (constructor).

Example

// ostream constructor
#include <iostream>
#include <fstream>
using namespace std;

int main () {
  filebuf fb;
  fb.open ("test.txt",ios::out);
  ostream os(&fb);
  os << "Test sentence\n";
  fb.close();
  return 0;
}

This code uses a filebuf object (derived from streambuf) to open the file test.txt. The buffer is then passed as parameter to the ostream constructor, associating it to the stream.

Objects of class ostream are seldom constructed directly. Generally some derived class is used (like the standard ones ofstream and ostringstream).

Basic template member declaration

( basic_ostream<charT,traits> )
explicit basic_ostream ( basic_streambuf<charT,traits>* sb );

See also

ios::init Initialize object [protected] (protected member function)

© The C++ Resources Network, 2000-2007 - All rights reserved
Spotted an error? - contact us