_getw

Pobiera liczbę całkowitą ze strumienia.

Składnia

int _getw(
   FILE *stream
);

Parametry

stream
Wskaźnik do FILE struktury.

Wartość zwracana

_getw Zwraca odczyt wartości całkowitej. Zwracana wartość EOF wskazuje błąd lub koniec pliku. Jednak ponieważ EOF wartość jest również wiarygodną wartością całkowitą, użyj feof polecenia lub ferror , aby zweryfikować warunek zakończenia pliku lub błędu. Jeśli stream parametr ma NULLwartość , wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonywanie jest dozwolone do kontynuowania, jest ustawione na EINVAL , errno a funkcja zwraca wartość EOF.

Uwagi

Funkcja _getw odczytuje następną wartość binarną typu int z pliku skojarzonego z stream i zwiększa skojarzony wskaźnik pliku (jeśli istnieje), aby wskazać następny nieprzeczytany znak. _getw nie zakłada żadnego specjalnego wyrównania elementów w strumieniu. Problemy z przenoszeniem mogą wystąpić, _getw ponieważ rozmiar int typu i kolejność bajtów w typie int różnią się w różnych systemach.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Wymagania

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Przykład

// 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 );
   }
}

Dane wejściowe: crt_getw.txt

Line one.
Line two.

Wynik

First data word in file: 0x656e694c

Zobacz też

We/Wy strumienia
_putw