_getw

Získá celé číslo z datového proudu.

Syntaxe

int _getw(
   FILE *stream
);

Parametry

stream
Ukazatel na FILE strukturu.

Vrácená hodnota

_getw vrátí celočíselnou hodnotu čtení. Návratová EOF hodnota označuje chybu nebo konec souboru. Vzhledem k tomu, že EOF hodnota je také legitimní celočíselná hodnota, použijte feof nebo ferror ověřte koncový nebo chybový stav. Pokud stream je NULL, je vyvolána neplatná obslužná rutina parametru, jak je popsáno v ověření parametru. Pokud je povoleno pokračovat provádění, errno je nastavena na EINVAL a funkce vrátí EOF.

Poznámky

Funkce _getw přečte další binární hodnotu typu int ze souboru přidruženého stream k souboru a zvýší přidružený ukazatel souboru (pokud existuje) tak, aby odkazovat na další nepřečtený znak. _getw nepředpokládá žádné zvláštní zarovnání položek v datovém proudu. K problémům s portováním může dojít _getw , protože velikost int typu a řazení bajtů v rámci int tohoto typu se liší v různých 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
_getw	<stdio.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Příklad

// crt_getw.c
// This program uses _getw to read a word
// from a stream, then performs an error check.

#include <stdio.h>
#include <stdlib.h>

int main( void )
{
   FILE *stream;
   int i;

   if( fopen_s( &stream, "crt_getw.txt", "rb" ) )
      printf( "Couldn't open file\n" );
   else
   {
      // Read a word from the stream:
      i = _getw( stream );

      // If there is an error...
      if( ferror( stream ) )
      {
         printf( "_getw failed\n" );
         clearerr_s( stream );
      }
      else
         printf( "First data word in file: 0x%.4x\n", i );
      fclose( stream );
   }
}

Vstup: crt_getw.txt

Line one.
Line two.

Výstup

First data word in file: 0x656e694c

Viz také

Vstupně-výstupní operace streamu
_putw