std::ostream_iterator

 

C++

Language

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Iterator library

Iterator primitives
iterator_traits
input_iterator_tag output_iterator_tag forward_iterator_tag bidirectional_iterator_tag random_access_iterator_tag
iterator
Iterator adaptors
reverse_iterator
move_iterator (C++11) back_insert_iterator front_insert_iterator insert_iterator	make_move_iterator (C++11) back_inserter front_inserter inserter
Stream iterators
istream_iterator
ostream_iterator
istreambuf_iterator
ostreambuf_iterator
Iterator operations
advance
distance
prev (C++11)
next (C++11)
Range access
begin (C++11)
end (C++11)

 

std::ostream_iterator

Member functions

ostream_iterator::ostream_iterator

ostream_iterator::~ostream_iterator

ostream_iterator::operator=

ostream_iterator::operator*

ostream_iterator::operator++ ostream_iterator::operator++(int)

 

Defined in header <iterator>
template< class T,           class CharT = char,           class Traits = std::char_traits<charT>> class ostream_iterator : public std::iterator<std::output_iterator_tag,                                               void, void, void, void>

std::ostream_iterator is a single-pass output iterator that writes successive objects of type T into the std::basic_ostream object for which it was constructed, using operator<<. Optional delimiter string is written to the output stream after every write operation. The write operation is performed when the iterator (whether dereferenced or not) is assigned to. Incrementing the std::ostream_iterator is a no-op.

In a typical implementation, the only data members of std::ostream_iterator are a pointer to the associated std::basic_ostream and a pointer to the first character in the delimiter string.

When writing characters, std::ostreambuf_iterator is more efficient, since it avoids the overhead of constructing and destructing the sentry object once per character.

Member types

Member type	Definition
char_type	CharT
traits_type	Traits
ostream_type	std::basic_ostream<CharT, Traits>

Member functions

(constructor)	constructs a new ostream_iterator (public member function)
(destructor)	destructs an ostream_iterator (public member function)
operator=	writes a object to the associated output sequence (public member function)
operator*	no-op (public member function)
operator++ operator++(int)	no-op (public member function)

Inherited from std::iterator

Member types

Member type	Definition
value_type	void
difference_type	void
pointer	void
reference	void
iterator_category	std::output_iterator_tag

Example

#include <iostream>
#include <sstream>
#include <iterator>
#include <algorithm>
int main()
{
    std::istringstream str("0.1 0.2 0.3 0.4");
    std::partial_sum( std::istream_iterator<double>(str),
                      std::istream_iterator<double>(),
                      std::ostream_iterator<double>(std::cout, " "));
}

Output:

0.1 0.3 0.6 1

See also

ostreambuf_iterator	output iterator that writes to std::basic_streambuf (class template)
istream_iterator	input iterator that reads from std::basic_istream (class template)