_getw

  • Статья

Получает значение типа integer из потока.

Синтаксис

int _getw(
   FILE *stream
);

Параметры

stream
Указатель на структуру FILE.

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

Функция _getw возвращает считанное целочисленное значение. Возвращаемое значение EOF указывает на ошибку или конец файла. Тем не менее, так как EOF также является допустимым целочисленным значением, можно использовать feof или ferror для проверки наличия ошибки или достижения конца файла. В противном streamNULLслучае вызывается недопустимый обработчик параметров, как описано в разделе "Проверка параметров". Если выполнение может быть продолжено, для errno задается значение EINVAL , и функция возвращает значение EOF.

Замечания

Функция _getw считывает следующее двоичное значение типа int из файла, связанного с stream файлом, и увеличивает связанный указатель файла (если он существует), чтобы указать на следующий непрочитанные символ. _getw Не предполагает никакого специального выравнивания элементов в потоке. При использовании функции _getw могут возникнуть проблемы с переносом, связанные с размером типа int и порядком байтов в типе int в разных системах.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Требования

Маршрут Обязательный заголовок
_getw <stdio.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

// crt_getw.c
// This program uses _getw to read a word
// from a stream, then performs an error check.

#include <stdio.h>
#include <stdlib.h>

int main( void )
{
   FILE *stream;
   int i;

   if( fopen_s( &stream, "crt_getw.txt", "rb" ) )
      printf( "Couldn't open file\n" );
   else
   {
      // Read a word from the stream:
      i = _getw( stream );

      // If there is an error...
      if( ferror( stream ) )
      {
         printf( "_getw failed\n" );
         clearerr_s( stream );
      }
      else
         printf( "First data word in file: 0x%.4x\n", i );
      fclose( stream );
   }
}

Входные данные: crt_getw.txt

Line one.
Line two.

Выходные данные

First data word in file: 0x656e694c

См. также

Потоковый ввод-вывод
_putw