_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

Viz také

Vstupně-výstupní operace streamu
_getw