_putw
更新 : 2007 年 11 月
ストリームに整数を書き込みます。
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 を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。