_putw_putw

ストリームに整数を書き込みます。Writes an integer to a stream.

構文Syntax

int _putw(
   int binint,
   FILE *stream
);

パラメーターParameters

binintbinint
出力されるバイナリ整数。Binary integer to be output.

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

戻り値Return Value

書き込まれた値を返します。Returns the value written. EOFの戻り値は、エラーを示している可能性があります。A return value of EOF might indicate an error. EOFも正当な整数値であるため、 ferrorを使用してエラーを確認します。Because EOF is also a legitimate integer value, use ferror to verify an error. Streamが null ポインターの場合は、「パラメーターの検証」で説明されているように、無効なパラメーターハンドラーが呼び出されます。If stream is a null pointer, the invalid parameter handler is invoked, as described in Parameter Validation. 実行の継続が許可された場合、この関数はerrnoEINVALに設定し、 EOFを返します。If execution is allowed to continue, this function sets errno to EINVAL and returns EOF.

エラー コードの詳細については、「_doserrno、errno、_sys_errlist、_sys_nerr」をご覧ください。For information about these and other error codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.

コメントRemarks

_Putw関数は、 int型のバイナリ値をストリームの現在位置に書き込みます。The _putw function writes a binary value of type int to the current position of stream. _putwは、ストリーム内の項目の配置には影響しません。また、特別な配置を想定していません。_putw does not affect the alignment of items in the stream nor does it assume any special alignment. _putwは、主に以前のライブラリとの互換性を維持するためのものです。_putw is primarily for compatibility with previous libraries. _Putwで移植性の問題が発生する可能性があります。これは 、int のサイズと int内のバイトの順序がシステム間で異なるためです。Portability problems might occur with _putw because the size of an int and the ordering of bytes within an int differ across systems.

要件Requirements

ルーチンRoutine 必須ヘッダーRequired header
_putw_putw <stdio.h><stdio.h>

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

ライブラリLibraries

C ランタイム ライブラリのすべてのバージョン。All versions of the C run-time libraries.

Example

// crt_putw.c
/* This program uses _putw to write a
* word to a stream, then performs an error check.
*/

#include <stdio.h>
#include <stdlib.h>

int main( void )
{
   FILE *stream;
   unsigned u;
   if( fopen_s( &stream, "data.out", "wb" ) )
      exit( 1 );
   for( u = 0; u < 10; u++ )
   {
      _putw( u + 0x2132, stream );   /* Write word to stream. */
      if( ferror( stream ) )         /* Make error check. */
      {
         printf( "_putw failed" );
         clearerr_s( stream );
         exit( 1 );
      }
   }
   printf( "Wrote ten words\n" );
   fclose( stream );
}

出力Output

Wrote ten words

参照See also

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