1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
3 .\" This is free documentation; you can redistribute it and/or
4 .\" modify it under the terms of the GNU General Public License as
5 .\" published by the Free Software Foundation; either version 2 of
6 .\" the License, or (at your option) any later version.
8 .\" References consulted:
9 .\" GNU glibc-2 source code and manual
10 .\" Dinkumware C library reference http://www.dinkumware.com/
11 .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
14 .\"*******************************************************************
16 .\" This file was generated with po4a. Translate the source file.
18 .\"*******************************************************************
19 .TH FWIDE 3 2011\-09\-17 GNU "Linux Programmer's Manual"
21 fwide \- FILE ストリームの入出力単位を設定または取得する
24 \fB#include <wchar.h>\fP
26 \fBint fwide(FILE *\fP\fIstream\fP\fB, int \fP\fImode\fP\fB);\fP
30 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
36 _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE ||
38 _ISOC95_SOURCE /* Since glibc 2.12 */ ||
40 _POSIX_C_SOURCE\ >=\ 200112L;
42 or \fIcc\ \-std=c99\fP
46 \fImode\fP がゼロならば \fBfwide\fP() 関数は \fIstream\fP の現在の 入出力単位を決定して返す。\fIstream\fP
47 がワイド文字単位のとき、 すなわちワイド文字 I/O は許されてバイト (char) I/O は許されていない ときには、正の値を返す。
48 \fIstream\fP がバイト単位のとき、すなわちバイト I/O は許されて ワイド文字 I/O は許されていないときには、負の値を返す。
49 \fIstream\fP の入出力単位がまだ決定されていない場合にはゼロが返される。 この場合には次の I/O 操作によって入出力単位が変更される (バイト
50 I/O 操作の場合にはバイト単位に、ワイド文字 I/O 操作の場合には ワイド文字単位になる)。
52 一度ストリームの入出力単位が決まると、変更することはできず、 ストリームがクローズ (close) されるまで保持される。
54 \fImode\fP がゼロでない場合には \fBfwide\fP() 関数は最初に \fIstream\fP の入出力単位を設定しようとする (\fImode\fP が 0
55 より大きい場合にはワイド文字単位に、 \fImode\fP が 0 より小さい場合にはバイト単位に設定しようとする)。
58 \fBfwide\fP() 関数はストリームの入出力単位の設定を試みた後にその値を返す。 正の返り値はワイド文字単位を、負の返り値はバイト単位を意味する。
63 バイト単位のストリームにワイド文字を出力にするには \fBfprintf\fP(3) 関数の \fB%lc\fP 変換や \fB%ls\fP
66 ワイド文字単位のストリームにバイト単位の出力を行うには \fBfwprintf\fP(3) 関数の \fB%c\fP 変換や \fB%s\fP
69 \fBfprintf\fP(3), \fBfwprintf\fP(3)