_getw

Celé číslo se získá z datového proudu.

int _getw( 
   FILE *stream 
);

Parametry

• stream
  Ukazatel FILE struktury.

Vrácená hodnota

_getwVrátí celočíselnou hodnotu, číst.Vrácená hodnota EOF označuje konec souboru nebo chyba.Ale protože EOF je také legitimní celočíselná hodnota, použijte feof nebo ferror podmínku konce souboru nebo Chyba ověření.Pokud stream je NULL, vyvolat neplatný parametr popisovače, jak je popsáno v Ověření parametrů.Pokud je povoleno spuštění pokračovat, errno je nastavena na EINVAL a vrátí funkce EOF.

Poznámky

_getw Funkci přečte Další binární hodnotu typu int ze souboru spojené s stream a zvýší ukazatel přidružený soubor přejděte na další nepřečtenou znak (pokud existuje)._getwnepředpokládá žádné zvláštní zarovnání položek v datovém proudu.Může dojít k problémům s kanály s _getw protože velikost int typu a pořadí bajtů v rámci int typu se liší v systémech.

Požadavky

Rutina	Požadované záhlaví
_getw	<stdio.h>

Další informace o kompatibilitě v tématu Compatibility v úvodu.

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ýsledek

First data word in file: 0x656e694c

Ekvivalent v rozhraní .NET Framework

Nelze použít Použijte volání funkce standardní C, PInvoke. Další informace naleznete v tématu Příklady vyvolat platformu.

Viz také

Referenční dokumentace

Proud I/O

_putw