getw()

Считать слово из потока

Прототип:

#include <stdio.h>
int getw( FILE *stream );

Аргументы:

stream
Поток, из которого требуется считать слово.

Библиотека:

libc

Описание:

Функция getw() возвращает следующее слово (т.е. целое число) из заданного потока ввода. Эта функция инкрементирует указатель, связанный с файлом, если таковой определен, чтобы он указывал на следующее слово. Размер слова равен размеру целому числу и зависит от устройства. Функция getw() не предполагает специального выравнивания в файле.

Возвращаемое значение:

Следующее слово или константа EOF по достижении конца файла или при ошибке; функция устанавливает EOF или индикатор ошибки потока.


Note: Используйте feof() или ferror() чтобы различать EOF и ошибки.

Коды ошибок:

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

Классификация:

Legacy Unix

Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Предостережения:

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

Тематические ссылки:

fclose(), feof(), ferror(), fgetc(), flockfile(), fopen(), fread(), getc(), getc_unlocked(), getchar(), getchar_unlocked(), gets(), putc(), putw(), scanf(), ungetc(),




Предыдущий раздел: Описание API системной библиотеки