_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 stream NULL, 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