_putw

  • [アーティクル]

ストリームに整数を書き込みます。

構文

int _putw(
   int binint,
   FILE *stream
);

パラメーター

binint
出力されるバイナリ整数。

stream
FILE 構造体へのポインター。

戻り値

書き込まれた値を返します。 EOF の戻り値はエラーを示す場合があります。 EOF も有効な整数値であるため、ferror を使用してエラーを確認します。 null ポインターの場合stream、「パラメーターの検証」で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、この関数は errno を EINVAL に設定し、EOF を返します。

これらのエラー コードおよびその他のエラー コードの詳細については、「errno、_doserrno、_sys_errlist、_sys_nerr」を参照してください。

解説

この関数は_putw、ストリームの現在位置に型intのバイナリ値を書き込みます。ストリーム_putw内の項目の配置に影響を与えることはなく、特別な配置も想定しません。 _putw は主に以前のライブラリとの互換性のための関数です。 int のサイズと、int 内のバイトの並び順がシステム間で異なるため、_putw で移植性の問題が発生することがあります。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

必要条件

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

互換性の詳細については、「 Compatibility」を参照してください。

ライブラリ

C ランタイム ライブラリのすべてのバージョン。

例

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

関連項目

ストリーム入出力
_getw