putwc(3C)

構文

#include <wchar.h>

wint_t putwc(wint_t wc, FILE *stream);

wint_t putwchar(wint_t wc);

wint_t fputwc(wint_t wc, FILE *stream);

説明

標準エラーストリーム stderr を除く出力ストリームは、デフォルトで、ファイルに出力される場合にはバッファー化され、ターミナルに出力される場合にはラインバッファー化されます。 標準エラー出力ストリーム stderr は、デフォルトではバッファー化されませんが、 freopen() fopen(3S) 参照) を使用すると、バッファー化もしくはラインバッファー化されます。 setbuf() もしくは setvbuf() setbuf(3S) 参照) を使用すると、ストリームのバッファーリング対象を変更できます。

これらの関数、型 wint_t、 値 WEOF は、ヘッダー <wchar.h> で定義されています。

アプリケーション使用法

_INCLUDE__STDC_A1_SOURCE プロトタイプを使用するには、 _INCLUDE__STDC_A1_SOURCE フラグをコンパイラオプションとして渡すか、ソースファイルでマクロとして定義する必要があります。

ストリームに fputwc()、 putwc()、 または putwchar() を適用すると、ストリームがバイト指向になります (orientation(5) を参照)。

多言語化対応

戻り値

正常終了すると、 putwc(), putwc_unlocked(), fputwc(), fputwc_unlocked(), putwchar(), および putwchar_unlocked() は、それぞれの書き出した値に対応するワイドキャラクタを返します。 失敗すると、定数 WEOF を返し、ストリームにエラーを示し、エラーを示す値を errno に設定します。

エラー

putwc(), putwc_unlocked(), putwchar(), putwchar_unlocked(), fputwc(), および fputwc_unlocked() は、 stream がバッファー化されていないか、 stream バッファーが掃き出される必要がある場合に失敗し、 write() コマンドを実行します。

write() 関数が実行されて、その他の errno 値が設定されることもあります write(2) 参照)。

警告

ワイドキャラクタ I/O ルーチンを使っているのに、標準入力からの読み込みには read() 自身を使っているようなプログラムでは、ラインバッファリングが混乱を招いたり、誤動作の原因になることがあります。 行の一部を出力ターミナルに出力した後で大量の計算を行う場合、計算を始める前に標準出力に対して fflush() fclose(3S) 参照) 処理を行う必要があります。

putwc_unlocked(), putwchar_unlocked(), fputwc_unlocked() インタフェースは廃止され、現在では既存の DCE アプリケーションとの互換性を保つためにだけサポートされています。新しいマルチスレッドアプリケーションでは、 putwc(), putwchar() および fputwc() を使用してください。

著者

putwc() は、OSF および HP で開発されました。

参照

fclose(3S), ferror(3S), flockfile(3S), fopen(3S), getwc(3C), fread(3S), printf(3S), putws(3C), setbuf(3S), orientation(5), thread_safety(5)

標準準拠

putwc(): XPG4

fputwc(): XPG4

putwchar(): XPG4