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


int _putw(
   int binint,
   FILE *stream


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

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.


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

既定では、この関数のグローバル状態はアプリケーションにスコープが設定されています。By default, this function's global state is scoped to the application. これを変更するには、「 CRT でのグローバル状態」を参照してください。To change this, see Global state in the CRT.


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

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


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


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


Wrote ten words

関連項目See also

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