次の方法で共有


_putw

更新 : 2007 年 11 月

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

int _putw(
   int binint,
   FILE *stream 
);

パラメータ

  • binint
    出力するバイナリ整数。

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

戻り値

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

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

解説

_putw 関数は、int 型のバイナリ値をストリームの現在の位置に書き込みます。_putw は、ストリームの項目の配列に影響を及ぼしません。また、特定の配列に依存することもありません。_putw は、主に以前のライブラリとの互換性のために用意されています。int のサイズと int 内のバイト順がシステムごとに異なるため、_putw 関数を使用すると移植性に関する問題が発生することがあります。

必要条件

ルーチン

必須ヘッダー

_putw

<stdio.h>

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

ライブラリ

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

.NET Framework の相当するアイテム

適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

参照

ストリーム入出力

_getw