_putw

Escribe un entero en una secuencia.

Sintaxis

int _putw(
   int binint,
   FILE *stream
);

Parámetros

binint
Entero binario que se generará.

stream
Puntero a la estructura de FILE.

Valor devuelto

Devuelve el valor escrito. El valor devuelto EOF podría indicar un error. Como EOF también es un valor entero legítimo, use ferror para comprobar un error. Si stream es un puntero nulo, se invoca el controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, la función establece errno en EINVAL y devuelve EOF.

Para información sobre estos y otros códigos de error, consulte errno, _doserrno_sys_errlist y _sys_nerr.

Comentarios

La _putw función escribe un valor binario de tipo int en la posición actual del flujo._putw No afecta a la alineación de los elementos de la secuencia ni supone ninguna alineación especial. _putw sirve principalmente para la compatibilidad con bibliotecas anteriores. Se pueden producir problemas de portabilidad con _putw porque el tamaño de un int y el orden de los bytes en un int son distintos en los sistemas.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Requisitos

Routine	Encabezado necesario
_putw	<stdio.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Bibliotecas

Todas las versiones de las bibliotecas en tiempo de ejecución de C.

Ejemplo

// 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 );
}

Salida

Wrote ten words

Consulte también

E/S de secuencia
_getw