OSDN Git Service

(split) LDP: draft snapshots from latest ja.po(s).
[linuxjm/LDP_man-pages.git] / draft / man3 / fgetwc.3
index 0bfa608..dbaf921 100644 (file)
 .\" References consulted:
 .\"   GNU glibc-2 source code and manual
 .\"   Dinkumware C library reference http://www.dinkumware.com/
-.\"   OpenGroup's Single Unix specification
+.\"   OpenGroup's Single UNIX specification
 .\"      http://www.UNIX-systems.org/online.html
 .\"   ISO/IEC 9899:1999
 .\"
 .\" Modified Tue Oct 16 23:18:40 BST 2001 by John Levon <moz@compsoc.man.ac.uk>
-.\"O
-.\" About this Japanese page, please contact to JM Project <JM@linux.or.jp>
-.\" Translated Sun Aug 29 15:03:27 JST 1999
-.\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
-.\" Updated Sun Dec 26 JST 1999 by Kentaro Shirakata <argrath@ub32.org>
-.\" Updated Fri Nov  2 JST 2001 by Kentaro Shirakata <argrath@ub32.org>
+.\"*******************************************************************
 .\"
-.TH FGETWC 3 1999-07-25 "GNU" "Linux Programmer's Manual"
-.\") .SH NAME
-.SH Ì¾Á°
-.\"O fgetwc, getwc \- read a wide character from a FILE stream
-fgetwc, getwc \- ¥ï¥¤¥Éʸ»ú¤ò FILE ¥¹¥È¥ê¡¼¥à¤«¤éÆɤ߹þ¤à
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH FGETWC 3 1999\-07\-25 GNU "Linux Programmer's Manual"
+.SH 名前
+fgetwc, getwc \- ワイド文字を FILE ストリームから読み込む
+.SH 書式
 .nf
-.B #include <stdio.h>
+\fB#include <stdio.h>\fP
 .br
-.B #include <wchar.h>
+\fB#include <wchar.h>\fP
 .sp
-.BI "wint_t fgetwc(FILE *" stream );
-.BI "wint_t getwc(FILE *" stream );
+\fBwint_t fgetwc(FILE *\fP\fIstream\fP\fB);\fP
+\fBwint_t getwc(FILE *\fP\fIstream\fP\fB);\fP
 .fi
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O The
-.\"O .BR fgetwc ()
-.\"O function is the wide-character equivalent
-.\"O of the
-.\"O .BR fgetc (3)
-.\"O function.
-.\"O It reads a wide character from \fIstream\fP and returns it.
-.\"O If the end of stream is reached, or if \fIferror(stream)\fP becomes true,
-.\"O it returns
-.\"O .BR WEOF .
-.\"O If a wide character conversion error occurs, it sets
-.\"O \fIerrno\fP to \fBEILSEQ\fP and returns
-.\"O .BR WEOF .
-.BR fgetwc ()
-´Ø¿ô¤Ï¡¢
-.BR fgetc (3)
-¤ËÂбþ¤¹¤ë¥ï¥¤¥Éʸ»ú´Ø¿ô¤Ç¤¢¤ë¡£
-¤³¤Î´Ø¿ô¤Ï \fIstream\fP ¤«¤é¥ï¥¤¥Éʸ»ú¤ò 1 Ê¸»úÆɤ߹þ¤ß¡¢¤³¤ì¤òÊÖ¤¹¡£
-¥¹¥È¥ê¡¼¥à¤Î½ªÃ¼¤Ë㤹¤ë¤«¡¢\fIferror(stream)\fP ¤¬¿¿¤Ë¤Ê¤Ã¤¿¾ì¹ç¤Ë¤Ï¡¢
-¤³¤Î´Ø¿ô¤Ï
-.B WEOF
-¤òÊÖ¤¹¡£
-¥ï¥¤¥Éʸ»úÊÑ´¹¤Ç¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¤Ï¡¢
-\fIerrno\fP ¤Ë \fBEILSEQ\fP ¤ò¥»¥Ã¥È¤·¡¢
-.B WEOF
-¤òÊÖ¤¹¡£
+.SH 説明
+\fBfgetwc\fP()  関数は、 \fBfgetc\fP(3)  に対応するワイド文字関数である。 この関数は \fIstream\fP からワイド文字を 1
+文字読み込み、これを返す。 ストリームの終端に達するか、\fIferror(stream)\fP が真になった場合には、 この関数は \fBWEOF\fP を返す。
+ワイド文字変換でエラーが発生した場合は、 \fIerrno\fP に \fBEILSEQ\fP をセットし、 \fBWEOF\fP を返す。
 .PP
-.\"O The
-.\"O .BR getwc ()
-.\"O function or macro functions identically to
-.\"O .BR fgetwc ().
-.BR getwc ()
-´Ø¿ô¤¢¤ë¤¤¤Ï¥Þ¥¯¥í¤Ï¡¢
-.BR fgetwc ()
-¤ÈÁ´¤¯Æ±¤¸Æ°ºî¤ò¤¹¤ë¡£
-.\"O It may be implemented as a macro, and may evaluate its argument
-.\"O more than once.
-.\"O There is no reason ever to use it.
-¤³¤Î´Ø¿ô¤Ï¥Þ¥¯¥í¤È¤·¤Æ¼ÂÁõ¤µ¤ì¤ë¤«¤â¤·¤ì¤Ê¤¤¤Î¤Ç¡¢°ú¤­¿ô¤¬Ê£¿ô²óɾ²Á¤µ
-¤ì¤ë¤«¤â¤·¤ì¤Ê¤¤¡£¤³¤Î´Ø¿ô¤ò»È¤¦Íýͳ¤Ï¤â¤Ï¤ä¸ºß¤·¤Ê¤¤¡£
+\fBgetwc\fP()  関数あるいはマクロは、 \fBfgetwc\fP()  と全く同じ動作をする。
+この関数はマクロとして実装されるかもしれないので、引き数が複数回評価さ れるかもしれない。この関数を使う理由はもはや存在しない。
 .PP
-.\"O For nonlocking counterparts, see
-.\"O .BR unlocked_stdio (3).
-¤³¤ì¤é¤Î½èÍý¤ò¥í¥Ã¥¯¤»¤º¤Ë¹Ô¤¤¤¿¤¤¤È¤­¤Ï¡¢
-.BR unlocked_stdio (3)
-¤ò»²¾È¤Î¤³¤È¡£
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O The
-.\"O .BR fgetwc ()
-.\"O function returns the next wide-character
-.\"O from the stream, or
-.\"O .BR WEOF .
-.BR fgetwc ()
-´Ø¿ô¤Ï¥¹¥È¥ê¡¼¥à¤Î¼¡¤Î¥ï¥¤¥Éʸ»ú¤«¡¢¤¢¤ë¤¤¤Ï
-.B WEOF
-¤òÊÖ¤¹¡£
-.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
-.\"O Apart from the usual ones, there is
-Ä̾ï¤Î¥¨¥é¡¼¤Ë²Ã¤¨¤Æ¡¢°Ê²¼¤Î¥¨¥é¡¼¤¬¤¢¤ë:
-.TP
-.B EILSEQ
-.\"O The data obtained from the input stream does not
-.\"O form a valid character.
-ÆþÎÏ¥¹¥È¥ê¡¼¥à¤«¤é¼èÆÀ¤·¤¿¥Ç¡¼¥¿¤¬¡¢Àµ¤·¤¤Ê¸»ú¤Ç¤Ê¤¤¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-C99, POSIX.1-2001.
-.\"O .SH NOTES
-.SH Ãí°Õ
-.\"O The behavior of
-.\"O .BR fgetwc ()
-.\"O depends on the
-.\"O .B LC_CTYPE
-.\"O category of the
-.\"O current locale.
-.BR fgetwc ()
-¤ÎÆ°ºî¤Ï¡¢¸½ºß¤Î¥í¥±¡¼¥ë¤Î
-.B LC_CTYPE
-¥«¥Æ¥´¥ê¤Ë°Í¸¤¹¤ë¡£
+これらの処理を停止せずに行いたいときは、 \fBunlocked_stdio\fP(3)  を参照のこと。
+.SH 返り値
+\fBfgetwc\fP()  関数はストリームの次のワイド文字か、あるいは \fBWEOF\fP を返す。
+.SH エラー
+通常のエラーに加えて、以下のエラーがある:
+.TP 
+\fBEILSEQ\fP
+入力ストリームから取得したデータが、正しい文字でない。
+.SH 準拠
+C99, POSIX.1\-2001.
+.SH 注意
+\fBfgetwc\fP()  の動作は、現在のロケールの \fBLC_CTYPE\fP カテゴリに依存する。
 .PP
-.\"O In the absence of additional information passed to the
-.\"O .BR fopen (3)
-.\"O call, it is
-.\"O reasonable to expect that
-.\"O .BR fgetwc ()
-.\"O will actually read a multibyte sequence
-.\"O from the stream and then convert it to a wide character.
-.BR fopen (3)
-¥·¥¹¥Æ¥à¥³¡¼¥ë¤ËÅϤ¹ÄɲþðÊ󤬤ʤ¤¾ì¹ç¤Ë¤Ï¡¢
-.BR fgetwc ()
-¤¬¼ÂºÝ
-¤Ë¤Ï¥Þ¥ë¥Á¥Ð¥¤¥È¥·¡¼¥±¥ó¥¹¤ò¥¹¥È¥ê¡¼¥à¤«¤éÆɤ߹þ¤ß¡¢¤³¤ì¤ò¥ï¥¤¥Éʸ»ú¤Ë
-ÊÑ´¹¤¹¤ë¤È´üÂÔ¤¹¤ë¤³¤È¤ÏŬÀڤǤ¢¤ë¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR fgetws (3),
-.BR fputwc (3),
-.BR ungetwc (3),
-.BR unlocked_stdio (3)
+\fBfopen\fP(3)  システムコールに渡す追加情報がない場合には、 \fBfgetwc\fP()  が実際
+にはマルチバイトシーケンスをストリームから読み込み、これをワイド文字に 変換すると期待することは適切である。
+.SH 関連項目
+\fBfgetws\fP(3), \fBfputwc\fP(3), \fBungetwc\fP(3), \fBunlocked_stdio\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.41 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。