_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.

e6ebches.collapse_all(ja-jp,VS.110).gif出力

First data word in file: 0x656e694c

同等の .NET Framework 関数

該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

関連項目

ストリーム入出力

_putw