std::ostreambuf_iterator<CharT,Traits>:: ostreambuf_iterator
From cppreference.net
<
cpp
|
iterator
|
ostreambuf iterator
C++
Iterator library
| Iterator concepts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Iterator primitives | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Algorithm concepts and utilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Indirect callable concepts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Common algorithm requirements | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Utilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Iterator adaptors | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
std::ostreambuf_iterator
| Member functions | ||||
|
ostreambuf_iterator::ostreambuf_iterator
|
||||
| (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
|
удалён вместе с
требованием |