_putw
Записывает целое число в поток.
int _putw(
int binint,
FILE *stream
);
Параметры
binint
Бинарное целое число, которое необходимо вывести.stream
Указатель на структуру FILE.
Возвращаемое значение
Возвращает записанное значение. Возвращаемое значение EOF может указывать на ошибку. Поскольку EOF также является допустимым целочисленным значением, используйте ferror для проверки на ошибку. Если stream является пустым указателем, то вызывается обработчик недопустимого параметра, как описано в разделе Проверка параметров. Если продолжение выполнения разрешено, функция устанавливает errno в EINVAL и возвращает EOF.
Дополнительные сведения об этих и других кодах ошибок см. в разделе _doserrno, errno, _sys_errlist и _sys_nerr.
Заметки
Функция _putw записывает бинарное значение типа int в текущую позицию потока. _putw не влияет на выравнивание элементов в потоке и не предполагает какое-либо выравнивание. _putw предоставлена в основном для обеспечения совместимости с предыдущими библиотеками. Проблемы переносимости могут возникать при использовании _putw, поскольку размер int и порядок байтов внутри int различны на разных системах.
Требования
Подпрограмма |
Обязательный заголовок |
|---|---|
_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 );
}
Output
Wrote ten words
Эквивалент в .NET Framework
Неприменимо. Для вызова стандартной функции C используйте PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода.