OSDN Git Service

(split) LDP: Release pages for LDP v3.39.
[linuxjm/LDP_man-pages.git] / release / man3 / fgetwc.3
index 15c2894..85c24c9 100644 (file)
 .\"   ISO/IEC 9899:1999
 .\"
 .\" Modified Tue Oct 16 23:18:40 BST 2001 by John Levon <moz@compsoc.man.ac.uk>
-.\" 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 Ì¾Á°
-fgetwc, getwc \- ¥ï¥¤¥Éʸ»ú¤ò FILE ¥¹¥È¥ê¡¼¥à¤«¤éÆɤ߹þ¤à
-.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
-.SH ÀâÌÀ
-.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
-.BR getwc ()
-´Ø¿ô¤¢¤ë¤¤¤Ï¥Þ¥¯¥í¤Ï¡¢
-.BR fgetwc ()
-¤ÈÁ´¤¯Æ±¤¸Æ°ºî¤ò¤¹¤ë¡£
-¤³¤Î´Ø¿ô¤Ï¥Þ¥¯¥í¤È¤·¤Æ¼ÂÁõ¤µ¤ì¤ë¤«¤â¤·¤ì¤Ê¤¤¤Î¤Ç¡¢°ú¤­¿ô¤¬Ê£¿ô²óɾ²Á¤µ
-¤ì¤ë¤«¤â¤·¤ì¤Ê¤¤¡£¤³¤Î´Ø¿ô¤ò»È¤¦Íýͳ¤Ï¤â¤Ï¤ä¸ºß¤·¤Ê¤¤¡£
+\fBgetwc\fP()  関数あるいはマクロは、 \fBfgetwc\fP()  と全く同じ動作をする。
+この関数はマクロとして実装されるかもしれないので、引き数が複数回評価さ れるかもしれない。この関数を使う理由はもはや存在しない。
 .PP
-¤³¤ì¤é¤Î½èÍý¤ò¥í¥Ã¥¯¤»¤º¤Ë¹Ô¤¤¤¿¤¤¤È¤­¤Ï¡¢
-.BR unlocked_stdio (3)
-¤ò»²¾È¤Î¤³¤È¡£
-.SH ÊÖ¤êÃÍ
-.BR fgetwc ()
-´Ø¿ô¤Ï¥¹¥È¥ê¡¼¥à¤Î¼¡¤Î¥ï¥¤¥Éʸ»ú¤«¡¢¤¢¤ë¤¤¤Ï
-.B WEOF
-¤òÊÖ¤¹¡£
-.SH ¥¨¥é¡¼
-Ä̾ï¤Î¥¨¥é¡¼¤Ë²Ã¤¨¤Æ¡¢°Ê²¼¤Î¥¨¥é¡¼¤¬¤¢¤ë:
-.TP
-.B EILSEQ
-ÆþÎÏ¥¹¥È¥ê¡¼¥à¤«¤é¼èÆÀ¤·¤¿¥Ç¡¼¥¿¤¬¡¢Àµ¤·¤¤Ê¸»ú¤Ç¤Ê¤¤¡£
-.SH ½àµò
-C99, POSIX.1-2001.
-.SH Ãí°Õ
-.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
-.BR fopen (3)
-¥·¥¹¥Æ¥à¥³¡¼¥ë¤ËÅϤ¹ÄɲþðÊ󤬤ʤ¤¾ì¹ç¤Ë¤Ï¡¢
-.BR fgetwc ()
-¤¬¼ÂºÝ
-¤Ë¤Ï¥Þ¥ë¥Á¥Ð¥¤¥È¥·¡¼¥±¥ó¥¹¤ò¥¹¥È¥ê¡¼¥à¤«¤éÆɤ߹þ¤ß¡¢¤³¤ì¤ò¥ï¥¤¥Éʸ»ú¤Ë
-ÊÑ´¹¤¹¤ë¤È´üÂÔ¤¹¤ë¤³¤È¤ÏŬÀڤǤ¢¤ë¡£
-.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)