Udostępnij za pośrednictwem


_getw

Pobiera całkowitą ze strumienia.

int _getw( 
   FILE *stream 
);

Parametry

  • stream
    Wskaźnik, aby FILE struktury.

Wartość zwracana

_getwZwraca wartość całkowitą odczytu.Zwracana wartość wynosząca EOF wskazuje błąd lub koniec pliku.Jednakże ponieważ EOF wartość jest również uzasadnione całkowitą wartość, należy użyć feof lub ferror do sprawdzenia warunek końca pliku lub błąd.Jeśli stream jest NULL, wywoływana jest funkcja obsługi nieprawidłowy parametr, jak opisano w Sprawdzanie poprawności parametru.Jeśli wykonanie jest dozwolone, aby kontynuować, errno jest ustawiona na EINVAL i funkcja zwraca EOF.

Uwagi

_getw Funkcji odczytuje wartość binarną dalej typu int z pliku skojarzonego z stream i inkrementuje wskaźnik skojarzony plik (jeśli istnieje) wskaż polecenie Następny znak nieprzeczytane._getwnie przyjmuje żadnych specjalnych wyrównania elementów w strumieniu.Mogą wystąpić problemy z przenoszenie, z _getw ponieważ rozmiar int typu i kolejności bajtów w ramach int typu różnią się w systemach.

Wymagania

Rozpoczęto wykonywanie procedury

Wymaganego nagłówka

_getw

<stdio.h>

Informacji dotyczących zgodności, zobacz zgodności we wprowadzeniu.

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.

Dane wyjściowe

First data word in file: 0x656e694c

Odpowiednik w programie .NET Framework

Nie dotyczy. Aby wywołać standardowych funkcji C, należy użyć PInvoke. Aby uzyskać więcej informacji, zobacz Przykłady wywołać platformy.

Zobacz też

Informacje

We/Wy strumienia

_putw