Namespaces
Variants

std::ostreambuf_iterator<CharT,Traits>:: ostreambuf_iterator

From cppreference.net
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)
(1)
ostreambuf_iterator ( streambuf_type * buffer ) throw ( ) ;
(до C++11)
ostreambuf_iterator ( streambuf_type * buffer ) noexcept ;
(начиная с C++11)
(2)
ostreambuf_iterator ( ostream_type & stream ) throw ( ) ;
(до C++11)
ostreambuf_iterator ( ostream_type & stream ) noexcept ;
(начиная с C++11)
1) Конструирует итератор, устанавливая закрытый член streambuf_type* в значение buffer и флаг failed() в значение false . Поведение не определено, если buffer является нулевым указателем.
2) То же, что и ostreambuf_iterator ( stream. rdbuf ( ) ) .

Параметры

stream - выходной поток, чей rdbuf() будет доступен этому итератору
buffer - выходной буфер потока, доступный этому итератору

Пример

#include <fstream>
#include <iostream>
#include <iterator>
int main()
{
    const char* file = "test.txt";
    {
        std::basic_filebuf<char> f;
        f.open(file, std::ios::out);
        std::ostreambuf_iterator<char> out1(&f);
        *out1 = 'a'; // writes to file via iterator
    }
    // read back from the file
    char a;
    std::cout << ((std::ifstream{file} >> a), a) << std::endl;
    std::ostreambuf_iterator<wchar_t> out2{std::wcout};
    *out2 = L'b';
}

Вывод:

a
b

Отчеты о дефектах

Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.

DR Применяется к Поведение в опубликованной версии Корректное поведение
LWG 112 C++98 требование "аргумент не может
быть null" применялось к перегрузке (2)
применяется к перегрузке
(1) вместо этого
P2325R3 C++20 конструктор по умолчанию был предоставлен, так как C++20
итераторы должны быть default_initializable
удалён вместе с
требованием