次の方法で共有

_putw

  • [アーティクル]

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

構文

int _putw(
   int binint,
   FILE *stream
);

パラメーター

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

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

戻り値

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

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

解説

_putw関数は、int型のバイナリ値を stream. _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