draft/man3/fwide.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
   4 .\" This is free documentation; you can redistribute it and/or
   5 .\" modify it under the terms of the GNU General Public License as
   6 .\" published by the Free Software Foundation; either version 2 of
   7 .\" the License, or (at your option) any later version.
   8 .\" %%%LICENSE_END
   9 .\"
  10 .\" References consulted:
  11 .\"   GNU glibc-2 source code and manual
  12 .\"   Dinkumware C library reference http://www.dinkumware.com/
  13 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
  14 .\"   ISO/IEC 9899:1999
  15 .\"
  16 .\"*******************************************************************
  17 .\"
  18 .\" This file was generated with po4a. Translate the source file.
  19 .\"
  20 .\"*******************************************************************
  21 .\"
  22 .\" Japanese Version Copyright (c) 1999 HANATAKA Shinya
  23 .\"         all rights reserved.
  24 .\" Translated Tue Jan 11 00:56:36 JST 2000
  25 .\"         by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  26 .\"
  27 .TH FWIDE 3 2011\-09\-17 GNU "Linux Programmer's Manual"
  28 .SH 名前
  29 fwide \- FILE ストリームの入出力単位を設定または取得する
  30 .SH 書式
  31 .nf
  32 \fB#include <wchar.h>\fP
  33 .sp
  34 \fBint fwide(FILE *\fP\fIstream\fP\fB, int \fP\fImode\fP\fB);\fP
  35 .fi
  36 .sp
  37 .in -4n
  38 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
  39 .in
  40 .ad l
  41 .sp
  42 \fBfwide\fP():
  43 .RS 4
  44 _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE ||
  45 .br
  46 _ISOC95_SOURCE /* Since glibc 2.12 */ ||
  47 .br
  48 _POSIX_C_SOURCE\ >=\ 200112L;
  49 .br
  50 or \fIcc\ \-std=c99\fP
  51 .RE
  52 .ad
  53 .SH 説明
  54 \fImode\fP がゼロならば \fBfwide\fP()  関数は \fIstream\fP の現在の 入出力単位を決定して返す。\fIstream\fP
  55 がワイド文字単位のとき、 すなわちワイド文字 I/O は許されてバイト (char) I/O は許されていない ときには、正の値を返す。
  56 \fIstream\fP がバイト単位のとき、すなわちバイト I/O は許されて ワイド文字 I/O は許されていないときには、負の値を返す。
  57 \fIstream\fP の入出力単位がまだ決定されていない場合にはゼロが返される。 この場合には次の I/O 操作によって入出力単位が変更される (バイト
  58 I/O 操作の場合にはバイト単位に、ワイド文字 I/O 操作の場合には ワイド文字単位になる)。
  59 .PP
  60 一度ストリームの入出力単位が決まると、変更することはできず、 ストリームがクローズ (close) されるまで保持される。
  61 .PP
  62 \fImode\fP がゼロでない場合には \fBfwide\fP()  関数は最初に \fIstream\fP の入出力単位を設定しようとする (\fImode\fP が 0
  63 より大きい場合にはワイド文字単位に、 \fImode\fP が 0 より小さい場合にはバイト単位に設定しようとする)。
  64 そして上記と同様に現在の入出力単位を返す。
  65 .SH 返り値
  66 \fBfwide\fP()  関数はストリームの入出力単位の設定を試みた後にその値を返す。 正の返り値はワイド文字単位を、負の返り値はバイト単位を意味する。
  67 返り値が 0 ならば未決定を意味する。
  68 .SH 準拠
  69 C99, POSIX.1\-2001.
  70 .SH 注意
  71 バイト単位のストリームにワイド文字を出力にするには \fBfprintf\fP(3)  関数の \fB%lc\fP 変換や \fB%ls\fP
  72 変換を使用することができる。
  73 .PP
  74 ワイド文字単位のストリームにバイト単位の出力を行うには \fBfwprintf\fP(3)  関数の \fB%c\fP 変換や \fB%s\fP
  75 変換を使用することができる。
  76 .SH 関連項目
  77 \fBfprintf\fP(3), \fBfwprintf\fP(3)
  78 .SH この文書について
  79 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
  80 である。プロジェクトの説明とバグ報告に関する情報は
  81 http://www.kernel.org/doc/man\-pages/ に書かれている。