_getw

Ruft eine Ganzzahl aus einem Stream ab.

Syntax

int _getw(
   FILE *stream
);

Parameter

stream
Zeiger auf die FILE-Struktur.

Rückgabewert

_getw gibt den gelesenen Wert in Form einer ganzen Zahl zurück. Ein Rückgabewert von EOF gibt einen Fehler oder ein Dateiende an. Da der EOF-Wert jedoch auch ein legitimer Wert einer Ganzzahl ist, verwenden Sie feof oder ferror, um eine Dateiendebedingung oder eine Fehlerbedingung zu prüfen. Wenn stream den Wert NULLannimmt, wird der Handler für ungültige Parameter aufgerufen, wie in Parameter Validation. Wenn die weitere Ausführung zugelassen wird, wird errno auf EINVAL festgelegt, und die Funktion gibt EOFbeschrieben.

Hinweise

Die _getw Funktion liest den nächsten binärwert des Typs int aus der Datei, die zugeordnet stream ist, und erhöht den zugeordneten Dateizeiger (sofern vorhanden), um auf das nächste ungelesene Zeichen zu zeigen. _getw übernimmt keine spezielle Ausrichtung von Elementen im Datenstrom. Probleme beim Portieren können mit _getw auftreten, da die Größe des int-Typs und die Anordnung der Bytes im int-Typ über Systeme hinweg unterschiedlich sind.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Anforderungen

Routine	Erforderlicher Header
_getw	<stdio.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

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

Weitere Informationen

Stream-E/A
_putw