名 前
btowc − シ ン グ ル バ イ ト を ワ イ ド 文 字 に コ ン バ ー ト す る
書 式
#include <wchar.h>
wint_t btowc(int c);
説 明
btowc() 関 数 は 初 期 シ フ ト 状 態 か ら 始 ま る 長 さ 1 の マ ル チ バ イ ト の シ ー ケ ン ス と し て 解 釈 さ れ 、 c を ワ イ ド 文 字 に コ ン バ ー ト し て 返 す 。 c が EOF も し く は 長 さ 1 の 無 効 な マ ル チ バ イ ト シ ー ケ ン ス の 場 合 、 btowc() 関 数 は WEOF を 返 す 。
返 り 値
btowc() 関 数 は シ ン グ ル バ イ ト c か ら コ ン バ ー ト さ れ た ワ イ ド 文 字 を 返 す 。 c が EOF も し く は 長 さ 1 の 無 効 な マ ル チ バ イ ト シ ー ケ ン ス の 場 合 、 btowc() 関 数 は WEOF を 返 す 。
準 拠
C99, POSIX.1−2001.
注 意
btowc() の 振 る 舞 い は 、 現 在 の ロ ケ ー ル の LC_CTYPE カ テ ゴ リ ー に 依 存 す る 。 こ の 関 数 は 使 用 さ れ る べ き で は な い 。 状 態 (state)を 持 っ た エ ン コ ー ド に は 使 え ず 、 マ ル チ バ イ ト シ ー ケ ン ス と は 違 い 、 必 ず し も シ ン グ ル バ イ ト を 取 り 扱 え る と は 限 ら な い 。 代 わ り に mbtowc() か 、 ス レ ッ ド セ ー フ な mbrtowc() を 使 用 す る こ と 。
関 連 項 目
mbrtowc(3), mbtowc(3), wctob(3)
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。