_getw

Ruft eine ganze Zahl aus einem Stream ab.

int _getw( 
   FILE *stream 
);

Parameter

• stream
  Zeiger auf die FILE Struktur.

Rückgabewert

_getw gibt das Lesen des ganzzahligen Werts zurück.Der Rückgabewert EOF gibt entweder einen Fehler oder ein Dateiende an.Da der EOF-Wert auch ein legitimer ganzzahliger Wert ist, verwenden Sie feof oder ferror , ein Dateiende oder einen Fehlerzustand zu überprüfen.Wenn streamNULLungültige Parameter ist, wird der Ereignishandler aufgerufen, wie in Parametervalidierungbeschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, wird errno zu EINVAL festgelegt, und die Funktion gibt EOFzurück.

Hinweise

Die _getw-Funktion liest den nächsten Binärwert des Typs int von der Datei, die stream zugeordnet ist und erhöht den Zeiger der zugeordneten Datei (falls vorhanden), um zum nächsten ungelesenen Zeichen zu veranschaulichen._getw nimmt keine besondere Ausrichtung der Elemente im Stream.Probleme beim Portieren können mit _getw auftreten, da die Größe des int-Typ und die Reihenfolge der Bytes im int-Typs über Systemen unterscheiden.

Anforderungen

Weitere Informationen finden Sie unter Kompatibilität Kompatibilität in der Einführung.

Beispiel

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

Eingabe: crt_getw.txt

Line one.
Line two.

Output

First data word in file: 0x656e694c

.NET Framework-Entsprechung

Nicht zutreffend. Um die Standard-C-Funktion aufrufen, verwenden Sie PInvoke. Weitere Informationen finden Sie unter Plattformaufruf-Beispiele.

Siehe auch

Referenz

Stream E/A

_putw