_getw_getw

ストリームから整数を取得します。Gets an integer from a stream.

構文Syntax

int _getw(
   FILE *stream
);

パラメーターParameters

一連stream
FILE 構造体へのポインター。Pointer to the FILE structure.

戻り値Return Value

_getwは、読み取られた整数値を返します。_getw returns the integer value read. EOFの戻り値は、エラーまたはファイルの末尾を示します。A return value of EOF indicates either an error or end of file. ただし、 EOF値も正しい整数値であるため、 feofまたはferrorを使用して、ファイルの終わりまたはエラーの状態を確認します。However, because the EOF value is also a legitimate integer value, use feof or ferror to verify an end-of-file or error condition. StreamNULLの場合は、「パラメーターの検証」で説明されているように、無効なパラメーターハンドラーが呼び出されます。If stream is NULL, the invalid parameter handler is invoked, as described in Parameter Validation. 実行の継続が許可された場合、 errnoEINVALに設定され、関数はEOFを返します。If execution is allowed to continue, errno is set to EINVAL and the function returns EOF.

RemarksRemarks

_Getw関数は、ストリームに関連付けられているファイルからint型の次のバイナリ値を読み取り、関連付けられているファイルポインター (存在する場合) を、次の未読文字を指すようにインクリメントします。The _getw function reads the next binary value of type int from the file associated with stream and increments the associated file pointer (if there is one) to point to the next unread character. _getwは、ストリーム内の項目の特別な配置を想定していません。_getw does not assume any special alignment of items in the stream. _Getwでは、 int型のサイズとint型内のバイトの順序がシステム間で異なるため、移植に関する問題が発生する可能性があります。Problems with porting can occur with _getw because the size of the int type and the ordering of bytes within the int type differ across systems.

必要条件Requirements

ルーチンによって返される値Routine 必須ヘッダーRequired header
_getw_getw <stdio.h><stdio.h>

互換性の詳細については、「 互換性」を参照してください。For more compatibility information, see Compatibility.

Example

// 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.txtInput: crt_getw.txt

Line one.
Line two.

OutputOutput

First data word in file: 0x656e694c

関連項目See also

ストリーム入出力Stream I/O
_putw_putw