_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