Collapse the table of content
Expand the table of content
Importante Es posible que este documento no represente los procedimientos recomendados para el desarrollo actual. Puede que los vínculos a las descargas y otros recursos ya no sean válidos. Encontrará aquí la versión que se recomienda en la actualidad. ArchiveDisclaimer


Writes an integer to a stream.

int _putw(
   int binint,
   FILE *stream 



Binary integer to be output.


Pointer to the FILE structure.

Returns the value written. A return value of EOF might indicate an error. Because EOF is also a legitimate integer value, use ferror to verify an error. If stream is a null pointer, the invalid parameter handler is invoked, as described in Parameter Validation. If execution is allowed to continue, this function sets errno to EINVAL and returns EOF.

For information about these and other error codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.

The _putw function writes a binary value of type int to the current position of stream. _putw does not affect the alignment of items in the stream nor does it assume any special alignment. _putw is primarily for compatibility with previous libraries. Portability problems might occur with _putw because the size of an int and the ordering of bytes within an int differ across systems.

Routine Required header Compatibility



Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003

For more compatibility information, see Compatibility in the Introduction.

All versions of the C run-time libraries.

// 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

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.

© 2015 Microsoft