_getw
ストリームから整数を取得します。
int _getw(
FILE *stream
);
パラメーター
- stream
FILE 構造体へのポインター。
戻り値
_getw は、整数値を返します。 EOF の戻り値エラーや、ファイルの終端を示します。 ただし、EOF 値も EOF またはエラー条件を検証する有効な整数値、使用 feof または ferror です。 stream が NULL の場合は、「パラメーターの検証」に説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、errno が EINVAL に設定され、関数から EOF が返されます。
解説
_getw 関数は stream に関連付けられたファイルの型 int の次のバイナリ値を読み込み、次の未読の文字を指すように関連ファイル ポインター (1 (存在する場合) をインクリメントします。 _getw は ストリームの項目の特別な配置はありません。 移植の問題は _getw と int 型のサイズと int 型内のバイトの順番がシステム間で異なることがあります。
必要条件
ルーチン |
必須ヘッダー |
---|---|
_getw |
<stdio.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// 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.
出力
First data word in file: 0x656e694c
同等の .NET Framework 関数
使用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。