istreambuf_iterator::istreambuf_iterator

Constructs an istreambuf_iterator that is initialized to read characters from the input stream.

istreambuf_iterator(
   streambuf_type* _Strbuf = 0
) throw( );
istreambuf_iterator(
   istream_type& _Istr
) throw( );

Parameters

• _Strbuf
  The input stream buffer to which the istreambuf_iterator is being attached.

• _Istr
  The input stream to which the istreambuf_iterator is being attached.

Remarks

The first constructor initializes the input stream-buffer pointer with _Strbuf. The second constructor initializes the input stream-buffer pointer with _Istr.rdbuf, and then eventually attempts to extract and store an object of type CharType.

Example

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

int main( )
{
   using namespace std;

   // Following declarations will not compile:
   istreambuf_iterator<char>::istream_type &istrm = cin;
   istreambuf_iterator<char>::streambuf_type *strmbf = cin.rdbuf( );

   cout << "(Try the example: 'Oh what a world!'\n"
      << " then an Enter key to insert into the output,\n"
      << " & use a ctrl-Z Enter key combination to exit): ";
   istreambuf_iterator<char> charReadIn ( cin );
   ostreambuf_iterator<char> charOut ( cout );

   // Used in conjunction with replace_copy algorithm
   // to insert into output stream and replace spaces
   // with hyphen-separators
   replace_copy ( charReadIn , istreambuf_iterator<char>( ),
      charOut , ' ' , '-' );
}

Oh what a world!

(Try the example: 'Oh what a world!'
 then an Enter key to insert into the output,
 & use a ctrl-Z Enter key combination to exit): Oh what a world!
Oh-what-a-world!
^Z

Requirements

Header: <iterator>

Namespace: std

See Also

Concepts

istreambuf_iterator Class

istreambuf_iterator Members

Standard Template Library