Namespaces
Variants

std:: ostreambuf_iterator

From cppreference.net
C++
Iterator library
Iterator concepts
Iterator primitives
Algorithm concepts and utilities
Indirect callable concepts
Common algorithm requirements
(C++20)
(C++20)
(C++20)
Utilities
(C++20)
Iterator adaptors
Range access
(C++11) (C++14)
(C++14) (C++14)
(C++11) (C++14)
(C++14) (C++14)
(C++17) (C++20)
(C++17)
(C++17)
std::ostreambuf_iterator
Определено в заголовочном файле <iterator>
template < class CharT, class Traits = std:: char_traits < CharT > >

class ostreambuf_iterator

: public std:: iterator < std:: output_iterator_tag , void , void , void , void >
(до C++17)
template < class CharT, class Traits = std:: char_traits < CharT > >
class ostreambuf_iterator ;
(начиная с C++17)

std::ostreambuf_iterator — это однонаправленный LegacyOutputIterator , который записывает последовательные символы в объект std::basic_streambuf , для которого он был создан. Фактическая операция записи выполняется при присваивании итератору (независимо от того, разыменован он или нет). Инкремент std::ostreambuf_iterator не имеет эффекта.

В типичной реализации единственными членами данных std::ostreambuf_iterator являются указатель на связанный std::basic_streambuf и булев флаг, указывающий, было ли достигнуто условие конца файла.

Содержание

Типы членов

Тип члена Определение
iterator_category std:: output_iterator_tag
value_type void
difference_type

void

(до C++20)

std::ptrdiff_t

(начиная с C++20)
pointer void
reference void
char_type CharT
traits_type Traits
streambuf_type std:: basic_streambuf < CharT, Traits >
ostream_type std:: basic_ostream < CharT, Traits >

Типы членов iterator_category , value_type , difference_type , pointer и reference должны быть получены путем наследования от std:: iterator < std:: output_iterator_tag , void , void , void , void > .

(до C++17)

Функции-члены

создает новый ostreambuf_iterator
(public member function)
(destructor)
(implicitly declared)
уничтожает ostreambuf_iterator
(public member function)
записывает символ в связанную выходную последовательность
(public member function)
пустая операция
(public member function)
пустая операция
(public member function)
проверяет, произошел ли сбой вывода
(public member function)

Пример

Запустить этот код 
#include <algorithm>
#include <iostream>
#include <iterator>
#include <string>
int main()
{
    std::string s = "This is an example\n";
    std::copy(s.begin(), s.end(), std::ostreambuf_iterator<char>(std::cout));
}

Вывод: 

This is an example

Смотрите также

входной итератор, который читает из std::basic_streambuf
(шаблон класса)
выходной итератор, который записывает в std::basic_ostream
(шаблон класса)