_getw

Bir akıştan tamsayı alır.

Sözdizimi

int _getw(
   FILE *stream
);

Parametreler

stream
Yapı işaretçisi FILE .

Dönüş değeri

_getw okunan tamsayı değerini döndürür. dönüş değeri EOF bir hatayı veya dosya sonunu gösterir. Ancak, değer aynı zamanda meşru bir tamsayı değeri olduğundanEOF, dosya sonu veya hata koşulunu doğrulamak için veya ferror kullanınfeof. ise streamNULL, parametre doğrulamasında açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, errno olarak ayarlanır EINVAL ve işlevi döndürür EOF.

Açıklamalar

İşlev, _getw türün int bir sonraki ikili değerini ilişkili dosyadan okur ve ilişkili stream dosya işaretçisini (varsa) bir sonraki okunmamış karaktere işaret etmek için artırır. _getw akıştaki öğelerin özel hizalaması olmadığını varsayar. Türün boyutu int ve tür içindeki int baytların sırası sistemler arasında farklılık gösterdiğinden, taşımayla _getw ilgili sorunlar oluşabilir.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Gereksinimler

Yordam	Gerekli başlık
_getw	<stdio.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

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

Giriş: crt_getw.txt

Line one.
Line two.

Çıktı

First data word in file: 0x656e694c

Ayrıca bkz.

Akış G/Ç
_putw