Шаблоны istreambufjterator и ostreambufJterator используются для чтения или записи отдельных символов с объектами типа baslc streambuf. Определения этих классов в заголовочном файле <iterator> выглядят примерно так:

namespace std {

template <class charT.

class traits = char traits<charT> > i streambufJ terator: template <class chart,

class traits = char traits<charT> > ostreambuf Jterator:

Эти итераторы представляют собой специализированные версии потоковых итераторов, описанных на с. 281, Единственное отличие заключается в том, что их элементы относятся к символьному типу.

Итераторы потоковых буферов вывода

Вывод строки в потоковый буфер с использованием итератора ostreambuf Jterator выполняется так:

Создание итератора для буфера или выходного потока cout std::ostreambufJterator<char> bufWr1ter(std::cout):

std::string helloChello. world\n"): std: :copy(hello.beginO. hello.endO. bufWriter);

В первой строке этого фрагмента конструируется итератор вывода типа ostreambuf Jterator для объекта cout. Вместо передачи выходного потока данных можно сразу передать указатель на потоковый буфер. Остальные команды конструируют объект string и копируют символы этого объекта через сконструированный итератор вывода.

В табл. 13.44 перечислены все операции итераторов потоковых буферов вывода. Этот интерфейс имеет много общего с потоковыми итераторами вывода (см. с. 282). Кроме того, итератор можно инициализировать буфером, а также проверить возможность записи через итератор функцией failed(). Если предыдущий вывод символов завершился неудачей, failed() возвращает true. В этом случае любые попытки записи оператором = ни к чему не приводят.

Таблица 13.44. Операции итераторов потоковых буферов вывода Выражение Описание

ostreanibuf lterator<char>(ostreann) Создание итератора потокового буфера вывода

для потока ostream

ostreambufJterator<char>(buffer ptr) Создание итератора потокового буфера вывода

для буфера, на который ссылается указатель buffer ptr

iter Фиктивная операция (возвращает iter)

Итераторы потоковых буферов ввода

в табл. 13.45 перечислены все операции итераторов потоковых буферов ввода. Этот интерфейс имеет много общего с потоковыми итераторами ввода (см. с. 284). Кроме того, итератор можно инициализировать буфером, а также проверить равенство двух итераторов потоковых буферов ввода функцией equal(). Два итератора потоковых буферов ввода равны, если они оба установлены в конец потока данных или ни один из них не установлен в конец потока данных.

Таблица 13.45. Операции итераторов потоковых буферов ввода

Выражение

Описание

Из этого следует несколько неочевидная формулировка эквивалентности объектов типа istreambufjterator. Два объекта типа istreambufjterator считаются эквивалентными, если оба итератора установлены в конец потока данных или ни один из них не установлен в конец потока данных (совпадают ли при этом буферы - значения не имеет). В частности, итератор, установленный в конец потока данных, может быть получен при конструировании итератора конструк-

тором по згмолчанию. Кроме того, итератор istreambuf iterator устанавливается в конец потока данных при попытке вывести итератор за конец потока (то есть когда SbumpcO возвращает traits type; :eof)- У такого поведения имеются два важных следствия.

О Интервал от текущей позиции до конца потока данных определяется двумя итераторами istreambufJterator<charT,traits>(womoK) (текущая позиция) и istreambufJterator<charT,traits>() (конец потока)» где поток относится к тину basicJstream<charT,traits> или basic streambuf<charT,traits>.

О Класс Istreambufjterator не позволяет создавать подинтервалы.

Пример использования итераторов потоковых буферов

Далее представлен классический фильтр, который просто выводит все прочитанные символы при помощи итераторов потоковых буферов. Он представляет собой видоизмененную версию примера, показанного на с. 586:

io/charcat2.cpp finclude <iostream> finclude <iterator> using namespace std:

int mainO {

Итератор потокового буфера ввода для cin i streambufJ terator<char> 1npos(ci n):

Итератор конца потока

1streambuf iterator<char> endpos:

Итератор потокового буфера вывода для cout ostreambuf 1terator<char> outpos(cout):

Пока итератор ввода остается действительным while (inpos !- endpos) {

*outpos - *inpos: Присвоить его значение итератору вывода

++inpos:

++outpos;

1ользовательские потоковые буферы

Потоковые буферы предназначены для выполнения ввода-вывода, а их интерфейс определяется классом basic streambuf. Для типов символов char и wcharj определены специализации streambuf и wstreambuf. Эти классы используются в качестве базовых при реализации взаимодействий через специальные каналы ввода-вывода, однако для этого необходимо хорошо понимать принципы работы потоковых буферов.