В стандартную библиотеку С++ входят несколько функций потоковых классов для чтения последовательностей символов. Возможности этих функций сравниваются в табл. 13.7.

Таблица 13.7. Функции чтения последовательностей символов

int Istream::get О

О Читает следующий символ.

О Возвращает прочитанный символ или EOF.

О В общем слзае возвращаемое значение относится к типу traits::intJype, а EOF - величина, возвращаемая при вызове traits: :eof(). Для istream это соответственно тип int и константа EOF. Следовательно, для istream эта функция соотвег-ствует функциям getchar() и getcO языка С.

О Возвращаемое значение не обязательно относится к типу символов потока данных; оно также может относиться к типу с более широким диапазоном значений. Без этого было бы невозможно отличить EOF от символа с соответствующим значением.

istream istream::get (chare с)

О Присваивает следующий символ аргументу с.

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

istreame Istream: :get (char* str. streamsize count)

istreame istream::get (char* str, streamsize count, char delim)

О Обе формы читают до count-i символов в строку str.

О Первая форма завершает чтение, если следующий читаемый символ является символом новой строки соответствующей кодировки. Для istream это символ \п, а для wistream - символ wchar t(\n) (см. с. 663). В общем случае используется символ widen(\n) (см. с. 602).

О Вторая форма завершает чтение, если следующий читаемый символ является разделителем delim.

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

О Завершающий символ (delim) не читается:

О Символ завершения строки прерывает чтение.

О Перед вызовом необходимо убедиться в том, что размер str достаточен для хранения count символов.

/streams /Stream::getl1ne {cher* str, streamsize count)

istreamSi /stream;;getline {char* str. streamsize count, char delim)

Обе формы идентичны предыдущим функциям get() со следующими исключениями:

□ чтение завершается не перед символом повой строки или delim соответственно, а включая этот символ, то есть символ новой строки или delim будет прочитан, если он встречается среди count-1 символов, но он не сохраняется в str,

□ если прочитанная строка содержит более count-1 символов, функции устанавливают флаг failbit

istr&ame 1 stream: -.ге&д (char* str. streamsize count)

О Читает count символов в строку str.

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

О Строка str не завершается автоматически символом завершения строки.

О Перед вызовом необходимо убедиться в том, что размер str достаточен для хранения count символов,

О Обнаружение признака конца файла в процессе чтения считается ошибкой, для которой устанавливается бит failbit (вдобавок к флагу eofbit).

streamsize istream::readsome (char* str, streamsize count)

О Читает до count символов в строку str.

О Возвращает количество прочитанных символов.

О Строка str не, завершается автоматически символом завершения строки.

О Перед вызовом необходимо убедиться в том, что размер str достаточен для хранения count символов.

О в отличие от функции readO функция readsomeO читает из потокового буфера все доступные символы (при помощи функции in avail() класса буфера). Например, она может использоваться в ситуациях, когда ввод поступает с клавиатуры или от других процессов, поэтому ожидание нежелательно. Обнаружение конца файла не считается ошибкой, а биты eofbit и failbit не устанавливаются.

streamsize 7stream;:gcount () const

О Возвращает количество символов, прочитанных последней операцией неформатированного ввода.

istream /stream::ignore С)

istreame istream:-.ignore (streamsize count)

istream istream:[ignore (streamsize count, int delim)

О Все формы извлекают символы из потока данных и игнорируют их.

О Первая форма игнорирует один символ.

О Вторая форма игнорирует до count символов.

О Третья форма игнорирует до count символов и прекращает работу тогда, когда будет извлечен и проигнорирован символ delim.

О Если значение count равно std::numeric limits<std::streamsize>::max(), то есть максимальному значению типа std::streamsize (см. с. 72), функция игнорирует все символы до тех пор, пока не будет обнаружен ограничитель delim или конец файла.

О Все формы возвращают объект потока данных. О Примеры:

□ игнорирование остатка строки:

cin.ignore(numeric limits<std: :streamsize>: :max(), Лп):

□ игнорирование всех оставшихся символов cin:

ci п. ignore(numeric l imits<std;: streamsize>::max());

int istream: :peek ()

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

О Если дальнейшее чтение невозможно, возвращает EOF.

О EOF - значение, возвращаемое traits::eofO. Для класса istream это константа EOF.

istream 7stream::unget О istreame stream;:putback {char c)

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

О Различия между функциями unget и pushback() заключаются в том, что putback() проверяет, был ли передаваемый символ с последним считанным символом.

О Если символ не удается вернуть или функция putback() пытается вернуть другой символ, устанавливается флаг badbit, что может привести к выдаче соответствующего исключения (см. с. 576).

О Максимальное количество символов, которые могут быть возвращены в поток данных этими функциями, зависит от реализации. По стандарту гаранти-