_putw

  • Статья

Записывает целое число в поток.

Синтаксис

int _putw(
   int binint,
   FILE *stream
);

Параметры

binint
Двоичное целое число, которое требуется вывести.

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

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

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

Сведения об этих и других кодах ошибок см. в разделе errno, _doserrno_sys_errlistи _sys_nerr.

Замечания

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

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

Требования

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

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

Библиотеки

Все версии библиотек времени выполнения языка C.

Пример

// crt_putw.c
/* This program uses _putw to write a
* word to a stream, then performs an error check.
*/

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

int main( void )
{
   FILE *stream;
   unsigned u;
   if( fopen_s( &stream, "data.out", "wb" ) )
      exit( 1 );
   for( u = 0; u < 10; u++ )
   {
      _putw( u + 0x2132, stream );   /* Write word to stream. */
      if( ferror( stream ) )         /* Make error check. */
      {
         printf( "_putw failed" );
         clearerr_s( stream );
         exit( 1 );
      }
   }
   printf( "Wrote ten words\n" );
   fclose( stream );
}

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

Wrote ten words

См. также

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