_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 );
}
Output
Wrote ten words