共用方式為

_getw

  • 發行項

從資料流取得整數。

int _getw( 
   FILE *stream 
);

參數

  • stream
    FILE 結構的指標。

傳回值

_getw 傳回讀取的整數值。 EOF 的傳回值表示錯誤或檔案結尾。 不過，因為 EOF 值也是合法的整數值、使用 feof 或 ferror 驗證檔案結尾或錯誤條件。 如果 stream 是 NULL，則叫用無效參數處理常式，如 參數驗證 中所述。 如果允許繼續執行，errno 會設定為 EINVAL 且函式會傳回 EOF。

備註

_getw 函式從相關 stream 的檔案中讀取下一個型別為 int 二進位值並將相關檔案指標 (如果有的話) 移至下一個未讀取的字元。 _getw 不會假設資料流中項目的任何特殊對齊。 因為 int 型別的大小和在 int 型別的位元組順序是系統相關的，移植 _getw 可能發生問題。

需求

常式

必要的標頭

_getw

<stdio.h>

如需更多關於相容性的資訊，請參閱入門介紹中的 相容性 (Compatibility) 。

範例

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

輸入:crt_getw.txt

Line one.
Line two.

Output

First data word in file: 0x656e694c

.NET Framework 對等用法

不適用。若要呼叫標準 C 函式，請使用 PInvoke。如需詳細資訊，請參閱平台叫用範例。

請參閱

參考

資料流 I/O

_putw