Manpages

名 前

fputwc, putwc − ワ イ ド 文 字 を FILE ス ト リ ー ム に 書 き 込 む

書 式

#include <stdio.h>
#include <wchar.h>

wint_t fputwc(wchar_t wc, FILE *stream);
wint_t putwc(wchar_t
wc, FILE *stream);

説 明

fputwc() 関 数 は 、 fputc(3) に 対 応 す る ワ イ ド 文 字 関 数 で あ る 。 こ の 関 数 は 、 ワ イ ド 文 字 wcstream に 書 き 込 む 。 ferror(stream) が 真 に な る と 、 こ の 関 数 は WEOF を 返 す 。 ワ イ ド 文 字 変 換 で エ ラ ー が 発 生 し た 場 合 は 、 errnoEILSEQ を セ ッ ト し 、 WEOF を 返 す 。 そ れ 以 外 の 場 合 で は 、 こ の 関 数 は wc を 返 す 。

putwc() 関 数 あ る い は マ ク ロ は 、 fputwc() と 全 く 同 じ 動 作 を す る 。 こ の 関 数 は マ ク ロ と し て 実 装 さ れ る か も し れ な い の で 、 引 き 数 が 複 数 回 評 価 さ れ る か も し れ な い 。 こ の 関 数 を 使 う 理 由 は も は や 存 在 し な い 。 こ れ ら の 処 理 を 停 止 せ ず に 行 い た い と き は 、 unlocked_stdio(3) を 参 照 の こ と 。

返 り 値

fputwc() 関 数 は 、 エ ラ ー が 起 き な け れ ば wc を 返 す 。 エ ラ ー の 場 合 に は WEOF が 返 り 、 errno に エ ラ ー の 原 因 を 示 す 値 が 設 定 さ れ る 。

エ ラ ー

通 常 の エ ラ ー に 加 え て 、 以 下 の エ ラ ー が あ る :

EILSEQ

wc か ら ス ト リ ー ム の 符 号 へ の 変 換 に 失 敗 し た 。

準 拠

C99, POSIX.1−2001.

注 意

fputwc() の 動 作 は 現 在 の ロ ケ ー ル の LC_CTYPE カ テ ゴ リ ー に 依 存 す る 。

fopen(3) シ ス テ ム コ ー ル に 渡 す 追 加 情 報 が な い 場 合 に は 、 fputwc() は 実 際 に は ワ イ ド 文 字 wc に 対 応 す る マ ル チ バ イ ト シ ー ケ ン ス を 書 き 込 む と 期 待 し て よ い 。

関 連 項 目

fgetwc(3), fputws(3), unlocked_stdio(3)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。