getw()

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

Прототип:

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

Аргументы:

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

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

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

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

Используйте 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 системной библиотеки