Manpages

名 前

ungetwc − ワ イ ド 文 字 を FILE ス ト リ ー ム へ 戻 す

書 式

#include <wchar.h>

wint_t ungetwc(wint_t wc, FILE *stream);

説 明

ungetwc() 関 数 は ungetc(3) 関 数 の ワ イ ド 文 字 版 で あ る 。 こ の 関 数 は ワ イ ド 文 字 を stream へ 戻 し て 、 そ れ を 返 す 。

wcWEOF の 場 合 、 WEOF を 返 す 。 wc が 不 正 な ワ イ ド 文 字 の 場 合 、 errnoEILSEQ を 設 定 し て WEOF を 返 す 。

wc が 有 効 な ワ イ ド 文 字 の 場 合 、 そ れ を ス ト リ ー ム へ と 戻 し て 後 の ワ イ ド 文 字 読 み 込 み 操 作 で 取 得 で き る よ う に す る 。 フ ァ イ ル 位 置 (file−position) 指 示 子 は 1以 上 戻 さ れ る 。 フ ァ イ ル 終 端 (end−of−file)指 示 子 は ク リ ア さ れ る 。 そ の フ ァ イ ル の 背 後 に あ る 記 憶 媒 体 は 影 響 を 受 け な い 。 注 意 : wc は ス ト リ ー ム か ら 読 み 込 ん だ 最 後 の ワ イ ド 文 字 で あ る 必 要 は な い 。 有 効 な ワ イ ド 文 字 な ら ば 何 で も 良 い 。 続 け て 複 数 の ワ イ ド 文 字 を 戻 す こ と を サ ポ ー ト し て い る 実 装 の 場 合 は 、 戻 し た ワ イ ド 文 字 は 、 戻 し た の と は 逆 の 順 番 で 読 み 込 ま れ る 。 し か し こ の 場 合 で も 一 段 階 の 戻 し し か 保 証 さ れ て い な い 。

返 り 値

ungetwc() 関 数 は 成 功 し た 場 合 に は wc を 返 す 。 失 敗 し た 場 合 に は WEOF を 返 す 。

属 性

マ ル チ ス レ ッ デ ィ ン グ (pthreads(7) 参 照 ) 関 数 ungetwc() は ス レ ッ ド セ ー フ で あ る 。

準 拠

C99.

注 意

ungetwc() 関 数 の 動 作 は 現 在 の ロ ケ ー ル の LC_CTYPE カ テ ゴ リ ー に 依 存 し て い る 。

関 連 項 目

fgetwc(3)

こ の 文 書 に つ い て

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