Компонентные функции класса istream

Функция

Прототип и краткое описание действий

gcount

get

getline

ignore

peek

putback

int gcount ( );

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

int get ( );

Передаёт из входного потока в прикладную программу следующий символ или EOF.

int get ( signed char *, int len, char = ‘\n’ ) ;

int get ( unsigned char *, int len, char = ‘\n’ );

Извлекает из входного потока символы и помещает их в буфер, на начало которого указывает char* . Передача символов завершается, если прочитано (len – 1) байтов, или встретился символ – разделитель (третий параметр в функции), или достигнут конец файла EOF. Завершающий нуль – символ всегда помещается в буфер, обозначая конец принятой строки, разделитель (последний параметр) не переносится в строку.

int get (unsigned char & );

int get (signed char & );

Извлекает из входного потока символ и помещает его в байт, на который указывает параметр char &.

int get (streambuf&, char = ‘\n’);

Извлекает символы из входного потока и помещает их в буфер потока, на который ссылается streambuf. Чтение символов прекращается, если в потоке встретился символ – разделитель (второй параметр).

istream& getline (signed char *, int, char = ‘\n’ );

istream getline (unsigned char *, int, char = ‘\n’ );

Совпадает с get () с тремя параметрами, но символ – разделитель также помещается в принятую строку символов.

istream& ignore (int n = 1, int delim = EOF);

Пропускает до n символов входного потока; останавливается, если встретился разделитель (второй параметр), по умолчанию равный EOF.

int peek ();

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

istream& putback (char);

Помещает символ назад во входной поток.

Продолжение табл. П.1.9

Функция

Прототип и краткое описание действий

read

seekg

telig

istream& read (signed char *, int);

istream& read (unsigned char *, int);

Извлекает из входного потока заданное вторым параметром число символов и помещает их в массив, на начало которого указывает первый параметр.

istrea& seekg (long);

Устанавливает указатель чтения входного потока на абсолютную позицию, заданную параметром long.

istream& seekg (long, seek_dir);

Перемещает указатель чтения входного потока на число байтов, заданное первым параметром. Второй параметр задает точку отсчета (0 – начало потока; 1 – текущая позиция потока; 2 – конец потока).

long telig ();

Возвращает текущую позицию указателя чтения входного потока.