release/man3/fwide.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   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.
   7 .\"
   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
  12 .\"   ISO/IEC 9899:1999
  13 .\"
  14 .\" Japanese Version Copyright (c) 1999 HANATAKA Shinya
  15 .\"         all rights reserved.
  16 .\" Translated Tue Jan 11 00:56:36 JST 2000
  17 .\"         by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  18 .\"
  19 .TH FWIDE 3  2011-09-17 "GNU" "Linux Programmer's Manual"
  20 .SH 名前
  21 fwide \- FILE ストリームの入出力単位を設定または取得する
  22 .SH 書式
  23 .nf
  24 .B #include <wchar.h>
  25 .sp
  26 .BI "int fwide(FILE *" stream ", int " mode );
  27 .fi
  28 .sp
  29 .in -4n
  30 .in
  31 .ad l
  32 .sp
  33 .BR fwide ():
  34 .RS 4
  35 _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE ||
  36 .br
  37 _ISOC95_SOURCE /* Since glibc 2.12 */ ||
  38 .br
  39 _POSIX_C_SOURCE\ >=\ 200112L;
  40 .br
  41 or
  42 .I cc\ -std=c99
  43 .RE
  44 .ad
  45 .SH 説明
  46 \fImode\fP がゼロならば
  47 .BR fwide ()
  48 関数は \fIstream\fP の現在の
  49 入出力単位を決定して返す。\fIstream\fP がワイド文字単位のとき、
  50 すなわちワイド文字 I/O は許されてバイト (char) I/O は許されていない
  51 ときには、正の値を返す。
  52 \fIstream\fP がバイト単位のとき、すなわちバイト I/O は許されて
  53 ワイド文字 I/O は許されていないときには、負の値を返す。
  54 \fIstream\fP の入出力単位がまだ決定されていない場合にはゼロが返される。
  55 この場合には次の I/O 操作によって入出力単位が変更される
  56 (バイト I/O 操作の場合にはバイト単位に、ワイド文字 I/O 操作の場合には
  57 ワイド文字単位になる)。
  58 .PP
  59 一度ストリームの入出力単位が決まると、変更することはできず、
  60 ストリームがクローズ (close) されるまで保持される。
  61 .PP
  62 \fImode\fP がゼロでない場合には
  63 .BR fwide ()
  64 関数は最初に \fIstream\fP
  65 の入出力単位を設定しようとする
  66 (\fImode\fP が 0 より大きい場合にはワイド文字単位に、
  67 \fImode\fP が 0 より小さい場合にはバイト単位に設定しようとする)。
  68 そして上記と同様に現在の入出力単位を返す。
  69
  70 .SH 返り値
  71 .BR fwide ()
  72 関数はストリームの入出力単位の設定を試みた後にその値を返す。
  73 正の返り値はワイド文字単位を、負の返り値はバイト単位を意味する。
  74 返り値が 0 ならば未決定を意味する。
  75 .SH 準拠
  76 C99, POSIX.1-2001.
  77 .SH 注意
  78 バイト単位のストリームにワイド文字を出力にするには
  79 .BR fprintf (3)
  80 関数の
  81 .B %lc
  82 変換や
  83 .B %ls
  84 変換を使用することができる。
  85 .PP
  86 ワイド文字単位のストリームにバイト単位の出力を行うには
  87 .BR fwprintf (3)
  88 関数の
  89 .B %c
  90 変換や
  91 .B %s
  92 変換を使用することができる。
  93 .SH 関連項目
  94 .BR fprintf (3),
  95 .BR fwprintf (3)