_getw
Mendapatkan bilangan bulat dari aliran.
Sintaks
int _getw(
FILE *stream
);
Parameter
stream
Penunjuk ke FILE struktur.
Nilai hasil
_getw mengembalikan nilai bilangan bulat yang dibaca. Nilai EOF pengembalian menunjukkan kesalahan atau akhir file. Namun, karena nilai tersebut EOF juga merupakan nilai bilangan bulat yang sah, gunakan feof atau ferror untuk memverifikasi kondisi akhir file atau kesalahan. Jika stream adalah NULL, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, errno diatur ke EINVAL dan fungsi mengembalikan EOF.
Keterangan
Fungsi membaca _getw nilai int biner jenis berikutnya dari file yang terkait dengan stream dan menaikkan penunjuk file terkait (jika ada) untuk menunjuk ke karakter belum dibaca berikutnya. _getw tidak mengasumsikan penyelarasan khusus item dalam aliran. Masalah dengan porting dapat terjadi _getw karena ukuran jenis int dan urutan byte dalam int jenis berbeda di seluruh sistem.
Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.
Persyaratan
| Rutin | Header yang diperlukan |
|---|---|
_getw |
<stdio.h> |
Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.
Contoh
// 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 );
}
}
Input: crt_getw.txt
Line one.
Line two.
Output
First data word in file: 0x656e694c