_putw

将一个整数写入到流中。

语法

int _putw(
   int binint,
   FILE *stream
);

参数

binint
要输出的二进制整数。

stream
指向 FILE 结构的指针。

返回值

返回写入的值。 返回值 EOF 可能表示一个错误。 因为 EOF 也是合法的整数值，请使用 ferror 来验证错误。 如果 stream 是空指针，则将调用无效的参数处理程序，如参数验证中所述。 如果允许执行继续，则该函数将 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

另请参阅

流 I/O
_getw