名 前
ungetwc − ワ イ ド 文 字 を FILE ス ト リ ー ム へ 戻 す
書 式
#include <wchar.h>
wint_t ungetwc(wint_t wc, FILE *stream);
説 明
ungetwc() 関 数 は ungetc(3) 関 数 の ワ イ ド 文 字 版 で あ る 。 こ の 関 数 は ワ イ ド 文 字 を stream へ 戻 し て 、 そ れ を 返 す 。
wc が WEOF の 場 合 、 WEOF を 返 す 。 wc が 不 正 な ワ イ ド 文 字 の 場 合 、 errno に EILSEQ を 設 定 し て WEOF を 返 す 。
wc が 有 効 な ワ イ ド 文 字 の 場 合 、 そ れ を ス ト リ ー ム へ と 戻 し て 後 の ワ イ ド 文 字 読 み 込 み 操 作 で 取 得 で き る よ う に す る 。 フ ァ イ ル 位 置 (file−position) 指 示 子 は 1以 上 戻 さ れ る 。 フ ァ イ ル 終 端 (end−of−file)指 示 子 は ク リ ア さ れ る 。 そ の フ ァ イ ル の 背 後 に あ る 記 憶 媒 体 は 影 響 を 受 け な い 。 注 意 : wc は ス ト リ ー ム か ら 読 み 込 ん だ 最 後 の ワ イ ド 文 字 で あ る 必 要 は な い 。 有 効 な ワ イ ド 文 字 な ら ば 何 で も 良 い 。 続 け て 複 数 の ワ イ ド 文 字 を 戻 す こ と を サ ポ ー ト し て い る 実 装 の 場 合 は 、 戻 し た ワ イ ド 文 字 は 、 戻 し た の と は 逆 の 順 番 で 読 み 込 ま れ る 。 し か し こ の 場 合 で も 一 段 階 の 戻 し し か 保 証 さ れ て い な い 。
返 り 値
ungetwc() 関 数 は 成 功 し た 場 合 に は wc を 返 す 。 失 敗 し た 場 合 に は WEOF を 返 す 。
属 性
マ ル チ ス レ ッ デ ィ ン グ (pthreads(7) 参 照 ) 関 数 ungetwc() は ス レ ッ ド セ ー フ で あ る 。
準 拠
C99.
注 意
ungetwc() 関 数 の 動 作 は 現 在 の ロ ケ ー ル の LC_CTYPE カ テ ゴ リ ー に 依 存 し て い る 。
関 連 項 目
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。