Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
std::ostrea...buf_iterator(3) C++ Standard Libarystd::ostrea...buf_iterator(3)

NAME
       std::ostreambuf_iterator::ostreambuf_iterator  -	std::ostreambuf_itera-
       tor::ostreambuf_iterator

Synopsis
	  ostreambuf_iterator(	streambuf_type*	 buffer	 )		(until
       C++11)
	  throw();
	  ostreambuf_iterator(	 streambuf_type*  buffer  )		(since
       C++11)
	  noexcept;					   (1)
	  ostreambuf_iterator(	       ostream_type&	     stream	     )
       (until C++11)
	  throw();					       (2)
	  ostreambuf_iterator(		ostream_type&	      stream	     )
       (since C++11)
	  noexcept;

	  1) Constructs	the iterator with the private  streambuf_type*	member
       set to buffer and
	  the  failed()	flag set to false. The behavior	is undefined if	buffer
       is a null
	  pointer.
	  2) Same as ostreambuf_iterator(stream.rdbuf()).

Parameters
	  stream - the output stream whose rdbuf() will	be  accessed  by  this
       iterator
	  buffer - the output stream buffer to be accessed by this iterator

Example
       // Run this code

	#include <iostream>
	#include <fstream>
	#include <iterator>
	int main()
	{
	    std::basic_filebuf<char> f;
	    f.open("test.txt", std::ios::out);

	    std::ostreambuf_iterator<char> out1(&f);

	    std::ostreambuf_iterator<wchar_t> out2(std::wcout);

	    *out1 = 'a';
	    *out2 = L'a';
	}

	 Defect	reports

	  The following	behavior-changing defect reports were applied retroac-
       tively to
	  previously published C++ standards.

	    DR	      Applied	  to		   Behavior    as    published
       Correct behavior
			     default constructor was provided  as  C++20   re-
       moved along with	the
	  P2325R3  C++20       iterators				   re-
       quirement
			     must be default_initializable

http://cppreference.com		  2022.07.31	 std::ostrea...buf_iterator(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::ostreambuf_iterator::ostreambuf_iterator&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help