_putw
Zapíše celé číslo do datového proudu.
Syntaxe
int _putw(
int binint,
FILE *stream
);
Parametry
binint
Binární celé číslo, které má být výstupem.
stream
Ukazatel na FILE strukturu.
Vrácená hodnota
Vrátí zapsanou hodnotu. Návratová EOF hodnota může znamenat chybu. Protože EOF je také legitimní celočíselná hodnota, slouží ferror k ověření chyby. Pokud stream je ukazatel null, je vyvolána neplatná obslužná rutina parametru, jak je popsáno v ověření parametru. Pokud je spuštění povoleno pokračovat, tato funkce nastaví errno EINVAL a vrátí EOF.
Informace o těchto a dalších kódech chyb naleznete v tématu , , , a_sys_nerr . _sys_errlist_doserrnoerrno
Poznámky
Funkce _putw zapíše binární hodnotu typu int na aktuální pozici datového proudu. _putw Nemá vliv na zarovnání položek ve streamu ani nepředpokládá žádné zvláštní zarovnání. _putw je primárně z důvodu kompatibility s předchozími knihovnami. K problémům _putw s přenositelností může dojít, protože velikost int a řazení bajtů v různých int systémech.
Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.
Požadavky
| Rutina | Požadovaný hlavičkový soubor |
|---|---|
_putw |
<stdio.h> |
Další informace o kompatibilitě najdete v tématu Kompatibilita.
Knihovny
Všechny verze knihoven runtime jazyka C.
Příklad
// 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 );
}
Výstup
Wrote ten words