_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

Lihat juga

Streaming I/O
_putw