OSDN Git Service

(split) LDP: Restore and add Copyrights for draft pages
[linuxjm/LDP_man-pages.git] / draft / man3 / fwide.3
index 8f97d3a..ccc4c04 100644 (file)
@@ -1,9 +1,11 @@
 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
 .\"
+.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
 .\" This is free documentation; you can redistribute it and/or
 .\" modify it under the terms of the GNU General Public License as
 .\" published by the Free Software Foundation; either version 2 of
 .\" the License, or (at your option) any later version.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"   GNU glibc-2 source code and manual
 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
 .\"   ISO/IEC 9899:1999
 .\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.\"
 .\" Japanese Version Copyright (c) 1999 HANATAKA Shinya
 .\"         all rights reserved.
 .\" Translated Tue Jan 11 00:56:36 JST 2000
 .\"         by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
 .\"
-.TH FWIDE 3  2010-09-20 "GNU" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH Ì¾Á°
-.\"O fwide \- set and determine the orientation of a FILE stream
-fwide \- FILE ¥¹¥È¥ê¡¼¥à¤ÎÆþ½ÐÎÏñ°Ì¤òÀßÄê¤Þ¤¿¤Ï¼èÆÀ¤¹¤ë
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.TH FWIDE 3 2011\-09\-17 GNU "Linux Programmer's Manual"
+.SH 名前
+fwide \- FILE ストリームの入出力単位を設定または取得する
+.SH 書式
 .nf
-.B #include <wchar.h>
+\fB#include <wchar.h>\fP
 .sp
-.BI "int fwide(FILE *" stream ", int " mode );
+\fBint fwide(FILE *\fP\fIstream\fP\fB, int \fP\fImode\fP\fB);\fP
 .fi
 .sp
 .in -4n
-.\"O Feature Test Macro Requirements for glibc (see
-.\"O .BR feature_test_macros (7)):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
 .ad l
 .sp
-.BR fwide ():
+\fBfwide\fP():
 .RS 4
 _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE ||
+.br
+_ISOC95_SOURCE /* Since glibc 2.12 */ ||
+.br
 _POSIX_C_SOURCE\ >=\ 200112L;
 .br
-or
-.I cc\ -std=c99
+or \fIcc\ \-std=c99\fP
 .RE
 .ad
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O When \fImode\fP is zero, the
-.\"O .BR fwide ()
-.\"O function determines the current
-.\"O orientation of \fIstream\fP.
-.\"O It returns a positive value if \fIstream\fP is
-.\"O wide-character oriented, that is, if wide-character I/O is permitted but char
-.\"O I/O is disallowed.
-.\"O It returns a negative value if \fIstream\fP is byte oriented,
-.\"O i.e., if char I/O is permitted but wide-character I/O is disallowed.
-.\"O It
-.\"O returns zero if \fIstream\fP has no orientation yet; in this case the next
-.\"O I/O operation might change the orientation (to byte oriented if it is a char
-\fImode\fP ¤¬¥¼¥í¤Ê¤é¤Ð
-.BR fwide ()
-´Ø¿ô¤Ï \fIstream\fP ¤Î¸½ºß¤Î
-.\"O I/O operation, or to wide-character oriented if it is a wide-character I/O
-.\"O operation).
-Æþ½ÐÎÏñ°Ì¤ò·èÄꤷ¤ÆÊÖ¤¹¡£\fIstream\fP ¤¬¥ï¥¤¥Éʸ»úñ°Ì¤Î¤È¤­¡¢
-¤¹¤Ê¤ï¤Á¥ï¥¤¥Éʸ»ú I/O ¤Ïµö¤µ¤ì¤Æ¥Ð¥¤¥È (char) I/O ¤Ïµö¤µ¤ì¤Æ¤¤¤Ê¤¤
-¤È¤­¤Ë¤Ï¡¢Àµ¤ÎÃͤòÊÖ¤¹¡£
-\fIstream\fP ¤¬¥Ð¥¤¥Èñ°Ì¤Î¤È¤­¡¢¤¹¤Ê¤ï¤Á¥Ð¥¤¥È I/O ¤Ïµö¤µ¤ì¤Æ
-¥ï¥¤¥Éʸ»ú I/O ¤Ïµö¤µ¤ì¤Æ¤¤¤Ê¤¤¤È¤­¤Ë¤Ï¡¢Éé¤ÎÃͤòÊÖ¤¹¡£
-\fIstream\fP ¤ÎÆþ½ÐÎÏñ°Ì¤¬¤Þ¤À·èÄꤵ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¤Ë¤Ï¥¼¥í¤¬ÊÖ¤µ¤ì¤ë¡£
-¤³¤Î¾ì¹ç¤Ë¤Ï¼¡¤Î I/O Áàºî¤Ë¤è¤Ã¤ÆÆþ½ÐÎÏñ°Ì¤¬Êѹ¹¤µ¤ì¤ë
-(¥Ð¥¤¥È I/O Áàºî¤Î¾ì¹ç¤Ë¤Ï¥Ð¥¤¥Èñ°Ì¤Ë¡¢¥ï¥¤¥Éʸ»ú I/O Áàºî¤Î¾ì¹ç¤Ë¤Ï
-¥ï¥¤¥Éʸ»úñ°Ì¤Ë¤Ê¤ë)¡£
+.SH 説明
+\fImode\fP がゼロならば \fBfwide\fP()  関数は \fIstream\fP の現在の 入出力単位を決定して返す。\fIstream\fP
+がワイド文字単位のとき、 すなわちワイド文字 I/O は許されてバイト (char) I/O は許されていない ときには、正の値を返す。
+\fIstream\fP がバイト単位のとき、すなわちバイト I/O は許されて ワイド文字 I/O は許されていないときには、負の値を返す。
+\fIstream\fP の入出力単位がまだ決定されていない場合にはゼロが返される。 この場合には次の I/O 操作によって入出力単位が変更される (バイト
+I/O 操作の場合にはバイト単位に、ワイド文字 I/O 操作の場合には ワイド文字単位になる)。
 .PP
-.\"O Once a stream has an orientation, it cannot be changed and persists until
-.\"O the stream is closed.
-°ìÅÙ¥¹¥È¥ê¡¼¥à¤ÎÆþ½ÐÎÏñ°Ì¤¬·è¤Þ¤ë¤È¡¢Êѹ¹¤¹¤ë¤³¤È¤Ï¤Ç¤­¤º¡¢
-¥¹¥È¥ê¡¼¥à¤¬¥¯¥í¡¼¥º (close) ¤µ¤ì¤ë¤Þ¤ÇÊÝ»ý¤µ¤ì¤ë¡£
+一度ストリームの入出力単位が決まると、変更することはできず、 ストリームがクローズ (close) されるまで保持される。
 .PP
-.\"O When \fImode\fP is nonzero, the
-.\"O .BR fwide ()
-.\"O function first attempts to set
-.\"O \fIstream\fP's orientation (to wide-character oriented
-.\"O if \fImode\fP is greater than 0, or
-.\"O to byte oriented if \fImode\fP is less than 0).
-.\"O It then returns a value denoting the
-.\"O current orientation, as above.
-\fImode\fP ¤¬¥¼¥í¤Ç¤Ê¤¤¾ì¹ç¤Ë¤Ï
-.BR fwide ()
-´Ø¿ô¤ÏºÇ½é¤Ë \fIstream\fP
-¤ÎÆþ½ÐÎÏñ°Ì¤òÀßÄꤷ¤è¤¦¤È¤¹¤ë
-(\fImode\fP ¤¬ 0 ¤è¤êÂ礭¤¤¾ì¹ç¤Ë¤Ï¥ï¥¤¥Éʸ»úñ°Ì¤Ë¡¢
-\fImode\fP ¤¬ 0 ¤è¤ê¾®¤µ¤¤¾ì¹ç¤Ë¤Ï¥Ð¥¤¥Èñ°Ì¤ËÀßÄꤷ¤è¤¦¤È¤¹¤ë)¡£
-¤½¤·¤Æ¾åµ­¤ÈƱÍͤ˸½ºß¤ÎÆþ½ÐÎÏñ°Ì¤òÊÖ¤¹¡£
-
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O The
-.\"O .BR fwide ()
-.\"O function returns the stream's orientation, after possibly
-.\"O changing it.
-.\"O A positive return value means wide-character oriented.
-.\"O A negative return value means byte oriented.
-.\"O A return value of zero means undecided.
-.BR fwide ()
-´Ø¿ô¤Ï¥¹¥È¥ê¡¼¥à¤ÎÆþ½ÐÎÏñ°Ì¤ÎÀßÄê¤ò»î¤ß¤¿¸å¤Ë¤½¤ÎÃͤòÊÖ¤¹¡£
-Àµ¤ÎÊÖ¤êÃͤϥ磻¥Éʸ»úñ°Ì¤ò¡¢Éé¤ÎÊÖ¤êÃͤϥХ¤¥Èñ°Ì¤ò°ÕÌ£¤¹¤ë¡£
-ÊÖ¤êÃͤ¬ 0 ¤Ê¤é¤Ð̤·èÄê¤ò°ÕÌ£¤¹¤ë¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-C99, POSIX.1-2001.
-.\"O .SH NOTES
-.SH Ãí°Õ
-.\"O Wide-character output to a byte oriented stream can be performed through the
-.\"O .BR fprintf (3)
-.\"O function with the
-.\"O .B %lc
-.\"O and
-.\"O .B %ls
-.\"O directives.
-¥Ð¥¤¥Èñ°Ì¤Î¥¹¥È¥ê¡¼¥à¤Ë¥ï¥¤¥Éʸ»ú¤ò½ÐÎϤˤ¹¤ë¤Ë¤Ï
-.BR fprintf (3)
-´Ø¿ô¤Î
-.B %lc
-ÊÑ´¹¤ä
-.B %ls
-ÊÑ´¹¤ò»ÈÍѤ¹¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
+\fImode\fP がゼロでない場合には \fBfwide\fP()  関数は最初に \fIstream\fP の入出力単位を設定しようとする (\fImode\fP が 0
+より大きい場合にはワイド文字単位に、 \fImode\fP が 0 より小さい場合にはバイト単位に設定しようとする)。
+そして上記と同様に現在の入出力単位を返す。
+.SH 返り値
+\fBfwide\fP()  関数はストリームの入出力単位の設定を試みた後にその値を返す。 正の返り値はワイド文字単位を、負の返り値はバイト単位を意味する。
+返り値が 0 ならば未決定を意味する。
+.SH 準拠
+C99, POSIX.1\-2001.
+.SH 注意
+バイト単位のストリームにワイド文字を出力にするには \fBfprintf\fP(3)  関数の \fB%lc\fP 変換や \fB%ls\fP
+変換を使用することができる。
 .PP
-.\"O Char oriented output to a wide-character oriented stream can be performed
-.\"O through the
-.\"O .BR fwprintf (3)
-.\"O function with the
-.\"O .B %c
-.\"O and
-.\"O .B %s
-.\"O directives.
-¥ï¥¤¥Éʸ»úñ°Ì¤Î¥¹¥È¥ê¡¼¥à¤Ë¥Ð¥¤¥Èñ°Ì¤Î½ÐÎϤò¹Ô¤¦¤Ë¤Ï
-.BR fwprintf (3)
-´Ø¿ô¤Î
-.B %c
-ÊÑ´¹¤ä
-.B %s
-ÊÑ´¹¤ò»ÈÍѤ¹¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR fprintf (3),
-.BR fwprintf (3)
+ワイド文字単位のストリームにバイト単位の出力を行うには \fBfwprintf\fP(3)  関数の \fB%c\fP 変換や \fB%s\fP
+変換を使用することができる。
+.SH 関連項目
+\fBfprintf\fP(3), \fBfwprintf\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。