std::ostream_iterator - Man Page

Provides output iterator semantics for streams.

Synopsis

Inherits std::iterator< output_iterator_tag, void, void, void, void >.

Public Types

typedef void difference_type
Distance between iterators is represented as this type.
typedef output_iterator_tag iterator_category
One of the tag types.
typedef void pointer
This type represents a pointer-to-value_type.
typedef void reference
This type represents a reference-to-value_type.
typedef void value_type
The type 'pointed to' by the iterator.

typedef _CharT char_type
Public typedef.
typedef _Traits traits_type
Public typedef.
typedef basic_ostream< _CharT, _Traits > ostream_type
Public typedef.

Public Member Functions

ostream_iterator (const ostream_iterator &__obj)
Copy constructor.
ostream_iterator (ostream_type &__s)
Construct from an ostream.
ostream_iterator (ostream_type &__s, const _CharT *__c)
ostream_iterator & operator* ()
ostream_iterator & operator++ ()
ostream_iterator & operator++ (int)
ostream_iterator & operator= (const _Tp &__value)
Writes value to underlying ostream using operator<<. If constructed with delimiter string, writes delimiter to ostream.
ostream_iterator & operator= (const ostream_iterator &)=default

Detailed Description

template<typename _Tp, typename _CharT = char, typename _Traits = char_traits<_CharT>>

class std::ostream_iterator< _Tp, _CharT, _Traits >" Provides output iterator semantics for streams.

This class provides an iterator to write to an ostream. The type Tp is the only type written by this iterator and there must be an operator<<(Tp) defined.

Template Parameters

_Tp The type to write to the ostream.
_CharT The ostream char_type.
_Traits The ostream char_traits.

Definition at line 176 of file stream_iterator.h.

Member Typedef Documentation

template<typename _Tp , typename _CharT  = char, typename _Traits  = char_traits<_CharT>> typedef _CharT std::ostream_iterator< _Tp, _CharT, _Traits >::char_type

Public typedef.

Definition at line 185 of file stream_iterator.h.

typedef void  std::iterator< output_iterator_tag , void , void , void , void  >::difference_type [inherited]

Distance between iterators is represented as this type.

Definition at line 134 of file stl_iterator_base_types.h.

typedef output_iterator_tag  std::iterator< output_iterator_tag , void , void , void , void  >::iterator_category [inherited]

One of the tag types.

Definition at line 130 of file stl_iterator_base_types.h.

template<typename _Tp , typename _CharT  = char, typename _Traits  = char_traits<_CharT>> typedef basic_ostream<_CharT, _Traits> std::ostream_iterator< _Tp, _CharT, _Traits >::ostream_type

Public typedef.

Definition at line 187 of file stream_iterator.h.

typedef void  std::iterator< output_iterator_tag , void , void , void , void  >::pointer [inherited]

This type represents a pointer-to-value_type.

Definition at line 136 of file stl_iterator_base_types.h.

typedef void  std::iterator< output_iterator_tag , void , void , void , void  >::reference [inherited]

This type represents a reference-to-value_type.

Definition at line 138 of file stl_iterator_base_types.h.

template<typename _Tp , typename _CharT  = char, typename _Traits  = char_traits<_CharT>> typedef _Traits std::ostream_iterator< _Tp, _CharT, _Traits >::traits_type

Public typedef.

Definition at line 186 of file stream_iterator.h.

typedef void  std::iterator< output_iterator_tag , void , void , void , void  >::value_type [inherited]

The type 'pointed to' by the iterator.

Definition at line 132 of file stl_iterator_base_types.h.

Constructor & Destructor Documentation

template<typename _Tp , typename _CharT  = char, typename _Traits  = char_traits<_CharT>> std::ostream_iterator< _Tp, _CharT, _Traits >::ostream_iterator (ostream_type & __s) [inline]

Construct from an ostream.

Definition at line 201 of file stream_iterator.h.

template<typename _Tp , typename _CharT  = char, typename _Traits  = char_traits<_CharT>> std::ostream_iterator< _Tp, _CharT, _Traits >::ostream_iterator (ostream_type & __s, const _CharT * __c) [inline]

Construct from an ostream.

The delimiter string c is written to the stream after every Tp written to the stream. The delimiter is not copied, and thus must not be destroyed while this iterator is in use.

Parameters

__s Underlying ostream to write to.
__c CharT delimiter string to insert.

Definition at line 214 of file stream_iterator.h.

template<typename _Tp , typename _CharT  = char, typename _Traits  = char_traits<_CharT>> std::ostream_iterator< _Tp, _CharT, _Traits >::ostream_iterator (const ostream_iterator< _Tp, _CharT, _Traits > & __obj) [inline]

Copy constructor.

Definition at line 218 of file stream_iterator.h.

Member Function Documentation

template<typename _Tp , typename _CharT  = char, typename _Traits  = char_traits<_CharT>> ostream_iterator& std::ostream_iterator< _Tp, _CharT, _Traits >::operator= (const _Tp & __value) [inline]

Writes value to underlying ostream using operator<<. If constructed with delimiter string, writes delimiter to ostream.

Definition at line 228 of file stream_iterator.h.

Author

Generated automatically by Doxygen for libstdc++ from the source code.

Info

Wed Apr 28 2021 libstdc++