_putw
ストリームに整数を書き込みます。
int _putw(
int binint,
FILE *stream
);
パラメーター
binint
出力するバイナリ整数。stream
FILE 構造体へのポインター。
戻り値
書き込まれた値を返します。 戻り値が EOF の場合は、エラーが発生していることがあります。 EOF は有効な整数値でもあるため、エラーが発生したかどうかを検証するには ferror を使用します。 stream が null ポインターの場合は、「パラメーターの検証」に説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、この関数は errno を EINVAL に設定し、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 を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。