名 前
fwide − FILE ス ト リ ー ム の 入 出 力 単 位 を 設 定 ま た は 取 得 す る
書 式
#include <wchar.h>
int fwide(FILE *stream, int mode);
glibc 向 け の 機 能 検 査 マ ク ロ の 要 件 (feature_test_macros(7) 参 照 ):
fwide():
_XOPEN_SOURCE >= 500
|| _ISOC99_SOURCE ||
_POSIX_C_SOURCE >= 200112L;
or cc −std=c99
説 明
mode が ゼ ロ な ら ば fwide() 関 数 は stream の 現 在 の 入 出 力 単 位 を 決 定 し て 返 す 。 stream が ワ イ ド 文 字 単 位 の と き 、 す な わ ち ワ イ ド 文 字 I/O は 許 さ れ て バ イ ト (char) I/O は 許 さ れ て い な い と き に は 、 正 の 値 を 返 す 。 stream が バ イ ト 単 位 の と き 、 す な わ ち バ イ ト I/O は 許 さ れ て ワ イ ド 文 字 I/O は 許 さ れ て い な い と き に は 、 負 の 値 を 返 す 。 stream の 入 出 力 単 位 が ま だ 決 定 さ れ て い な い 場 合 に は ゼ ロ が 返 さ れ る 。 こ の 場 合 に は 次 の I/O 操 作 に よ っ て 入 出 力 単 位 が 変 更 さ れ る (バ イ ト I/O 操 作 の 場 合 に は バ イ ト 単 位 に 、 ワ イ ド 文 字 I/O 操 作 の 場 合 に は ワ イ ド 文 字 単 位 に な る )。 一 度 ス ト リ ー ム の 入 出 力 単 位 が 決 ま る と 、 変 更 す る こ と は で き ず 、 ス ト リ ー ム が ク ロ ー ズ (close) さ れ る ま で 保 持 さ れ る 。
mode が ゼ ロ で な い 場 合 に は fwide() 関 数 は 最 初 に stream の 入 出 力 単 位 を 設 定 し よ う と す る (mode が 0 よ り 大 き い 場 合 に は ワ イ ド 文 字 単 位 に 、 mode が 0 よ り 小 さ い 場 合 に は バ イ ト 単 位 に 設 定 し よ う と す る )。 そ し て 上 記 と 同 様 に 現 在 の 入 出 力 単 位 を 返 す 。
返 り 値
fwide() 関 数 は ス ト リ ー ム の 入 出 力 単 位 の 設 定 を 試 み た 後 に そ の 値 を 返 す 。 正 の 返 り 値 は ワ イ ド 文 字 単 位 を 、 負 の 返 り 値 は バ イ ト 単 位 を 意 味 す る 。 返 り 値 が 0 な ら ば 未 決 定 を 意 味 す る 。
準 拠
C99, POSIX.1−2001.
注 意
バ イ ト 単 位 の ス ト リ ー ム に ワ イ ド 文 字 を 出 力 に す る に は fprintf(3) 関 数 の %lc 変 換 や %ls 変 換 を 使 用 す る こ と が で き る 。 ワ イ ド 文 字 単 位 の ス ト リ ー ム に バ イ ト 単 位 の 出 力 を 行 う に は fwprintf(3) 関 数 の %c 変 換 や %s 変 換 を 使 用 す る こ と が で き る 。
関 連 項 目
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。