первый элемент при вызове оператора * после инициализации. Тем ие менее реализация может отложить первое чтение до первого вызова оператора *. Это означает, что потоковый итератор ввода не следует определять задолго до того, когда он действительно понадобится.

Потоковые итераторы вывода определяются для типа элемента Т:

namespace std (

template <class Т.

class charT char.

class traits = char traits<char T>.

class Distance = ptrdiff t > class istream 1terator;

Необязательные второй и третий аргументы шаблона определяют тип используемого потока данных (их смысл разъясняется на с. 562). Необязательный четвертый аргумент шаблона определяет тип разности итераторов.

Два потоковых итератора ввода равны, если выполняется одно из следующих условий:

О оба являются итераторами конца потока данных, то есть дальнейшее чтение невозможно;

О оба итератора могут читать из одного потока данных.

Следующий пример демонстрирует использование потокового итератора ввода.

iter/istriter.cpp #include <iostream> #include <iterator> using namespace std:

int mainO (

Создание потокового итератора ввода для чтения целых чисел из cin istream iterator<int> intReader(cin):

II Создание итератора конца потока данных vi stream i terator<i nt> i ntReaderEOF;

-/* Пока удается читать лексемы потоковым итератором ввода. * - дважды вывести прочитанное значение */

while CintReader != intReaderEOF) {

cout « "once: " « *intReader « endl:

cout « "once again: " « *intReader « endl; ++intReader;

В устаревших системах, не поддсржмиающих значения по умолчанию для параметров шаблонов, четвертый аргумент является обязательным (и перелается па месте второго аргумента), а аргументы типа потока данных отсутствуют.

Пусть входными данными программы является следующая последовательность:

1 2 3 f 4

Если запустить программу с этими входными данными, результат ее выполнения будет выглядеть так:

once: 1

once again: 1 once: 2

once again: 2 once: 3

once again: 3

Как видите, символ «h во входном потоке данных завершает работу программы. Из-за ошибки формата дальнейшее чтение невозможно, поэтому потоковый итератор ввода intReader равен итератору конца потока данных intReaderEOF (а условие завершения цикла становится равным false).

Еще один пример использования потоковых итераторов

в следующем примере задействованы обе разновидности потоковых итераторов, а также функция advance():

iter/advance2.cpp #include <iostrearfi> #include <str1ng> #1nclude <a1gorithm> using namespace std;

int mainO {

1strearfi iterator<string> cinPos(cin); ostream iterator<str1ng> coutPosCcout." ");

/* Пока при вводе не Судет достигнут конец файла * - записывать каждую третью строку

while CcinPos != istream iterator<string>()) { Пропустить следующие две строки advance CcinPos. 2);

Чтение и запись третьей строки if (cinPos != istream iterator<string>()) { *coutPos++ = *cinPos++;

cout « endl:

Вспомогательная функция advance() перемещает итератор к другой позиции (см. с. 265). При использовании с потоковыми итераторами вывода она позво-

ляет пропускать лексемы во входном потоке данных. Например, рассмотрим следующие входные данные:

No one objects if you are doing a good programming job for someone whom you respect.

Для этих данных будет получен такой результат:

objects are good for you

Прежде чем обращаться к значению *cinPos после вызова advance(), не забудьте убедиться в том, что потоковый итератор вывода остался действительным. Вызов оператора * для итератора конца потока данных приводит к непредсказуемым последствиям.

Другие примеры использования потоковых итераторов при чтении из потока данных и записи в поток данных приведены на с. 118, 361 и 378.

Грактовка итераторов

Итераторы делятся на категории (см. с. 257) в соответствии со своими специфическими возможностями. Иногда бывает удобно и даже необходимо переопределить поведение итератора для других категорий. Такое переопределение выполняется при помощи механизма тегов и трактовок итераторов.

Для каждой категории итераторов в стандартной библиотеке С++ определяется тег, предназначенный для ссылок на данную категорию:

namespace std {

struct outputJterator tag {

struct input iterator tag { ):

struct forward iterator tag : public input 1terator tag {

struct bidirectional iterator tag : public forward iterator tag {

struct random access iterator tag : public bidirect1onaljterator tag {

Обратите внимание иа наследование. Так, из представленной иерархии следует вывод, что любой прямой итератор forwardJterator tag является разновидностью итератора ввода input iterator tag. Но заметьте, что тег прямых итераторов

Спасибо Эндрю Кенигу (Andrew Kocnig) за хороший пример.