ostreambuf_iterator::ostreambuf_iterator

Constructs an ostreambuf_iterator that is initialized to write characters to the output stream.

ostreambuf_iterator(
   streambuf_type* _Strbuf
) throw( );
ostreambuf_iterator(
   ostream_type& _Ostr
) throw( );

Parameters

  • _Strbuf
    The output streambuf object used to initialize the output stream-buffer pointer.

  • _Ostr
    The output stream object used to initialize the output stream-buffer pointer.

Remarks

The first constructor initializes the output stream-buffer pointer with _Strbuf.

The second constructor initializes the output stream-buffer pointer with _Ostr.rdbuf. The stored pointer must not be a null pointer.

Example

// ostreambuf_iterator_ostreambuf_iterator.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;

   // ostreambuf_iterator for stream cout
   ostreambuf_iterator<char> charOut ( cout );
   
   *charOut = 'O';
   charOut ++;
   *charOut  = 'U';
   charOut ++;   
   *charOut = 'T';
   cout << " are characters output individually." << endl;

   ostreambuf_iterator<char> strOut ( cout );
   string str = "These characters are being written to the output stream.\n ";
   copy ( str.begin ( ), str. end ( ), strOut );
}

OUT are characters output individually.
These characters are being written to the output stream.

Requirements

Header: <iterator>

Namespace: std

See Also

Concepts

ostreambuf_iterator Class

ostreambuf_iterator Members

Standard Template Library