OSDN Git Service

(split) Convert release and draft pages to UTF-8.
[linuxjm/LDP_man-pages.git] / release / man3 / btowc.3
index 5f2d300..608b759 100644 (file)
 .\"         all rights reserved.
 .\" Translated Sep 11 1999, HAYAKAWA Hitoshi <cz8cb01@linux.or.jp>
 .\"
-.\"WORD:    locale  ¥í¥±¡¼¥ë
-.\"WORD:    convert ¥³¥ó¥Ð¡¼¥È
-.\"WORD:    single byte ¥·¥ó¥°¥ë¥Ð¥¤¥È
-.\"WORD:    wide character ¥ï¥¤¥É¥­¥ã¥é¥¯¥¿¡¼
-.\"WORD:    state ¾õÂÖ
+.\"WORD:    locale  ロケール
+.\"WORD:    convert コンバート
+.\"WORD:    single byte シングルバイト
+.\"WORD:    wide character ã\83¯ã\82¤ã\83\89ã\82­ã\83£ã\83©ã\82¯ã\82¿ã\83¼
+.\"WORD:    state 状態
 .\"
 .TH BTOWC 3 2011-09-22 "GNU" "Linux Programmer's Manual"
-.SH Ì¾Á°
-btowc \- ¥·¥ó¥°¥ë¥Ð¥¤¥È¤ò¥ï¥¤¥Éʸ»ú¤Ë¥³¥ó¥Ð¡¼¥È¤¹¤ë
-.SH ½ñ¼°
+.SH 名前
+btowc \- シングルバイトをワイド文字にコンバートする
+.SH 書式
 .nf
 .B #include <wchar.h>
 .sp
 .BI "wint_t btowc(int " c );
 .fi
-.SH ÀâÌÀ
+.SH 説明
 .BR btowc ()
-´Ø¿ô¤Ï½é´ü¥·¥Õ¥È¾õÂÖ¤«¤é»Ï¤Þ¤ëŤµ 1 ¤Î¥Þ¥ë¥Á¥Ð¥¤¥È¤Î¥·¡¼¥±¥ó¥¹¤È¤·¤Æ
-²ò¼á¤µ¤ì¡¢\fIc\fP ¤ò¥ï¥¤¥Éʸ»ú¤Ë¥³¥ó¥Ð¡¼¥È¤·¤ÆÊÖ¤¹¡£
-\fIc\fP ¤¬
+関数は初期シフト状態から始まる長さ 1 のマルチバイトのシーケンスとして
+解釈され、\fIc\fP をワイド文字にコンバートして返す。
+\fIc\fP 
 .B EOF
-¤â¤·¤¯¤ÏŤµ 1 ¤Î̵¸ú¤Ê¥Þ¥ë¥Á¥Ð¥¤¥È¥·¡¼¥±¥ó¥¹¤Î¾ì¹ç¡¢
+もしくは長さ 1 の無効なマルチバイトシーケンスの場合、
 .BR btowc ()
-´Ø¿ô¤Ï
+関数は
 .B WEOF
-¤òÊÖ¤¹¡£
-.SH ÊÖ¤êÃÍ
+を返す。
+.SH 返り値
 .BR btowc ()
-´Ø¿ô¤Ï¥·¥ó¥°¥ë¥Ð¥¤¥È \fIc\fP ¤«¤é¥³¥ó¥Ð¡¼¥È¤µ¤ì¤¿¥ï¥¤¥Éʸ»ú¤òÊÖ¤¹¡£
-\fIc\fP ¤¬
+関数はシングルバイト \fIc\fP からコンバートされたワイド文字を返す。
+\fIc\fP 
 .B EOF
-¤â¤·¤¯¤ÏŤµ 1 ¤Î̵¸ú¤Ê¥Þ¥ë¥Á¥Ð¥¤¥È¥·¡¼¥±¥ó¥¹¤Î¾ì¹ç¡¢
+もしくは長さ 1 の無効なマルチバイトシーケンスの場合、
 .BR btowc ()
-´Ø¿ô¤Ï
+関数は
 .B WEOF
-¤òÊÖ¤¹¡£
-.SH ½àµò
+を返す。
+.SH 準拠
 C99, POSIX.1-2001.
-.SH Ãí°Õ
+.SH 注意
 .BR btowc ()
-¤Î¿¶¤ëÉñ¤¤¤Ï¡¢¸½ºß¤Î¥í¥±¡¼¥ë¤Î
+の振る舞いは、現在のロケールの
 .B LC_CTYPE
-¥«¥Æ¥´¥ê¡¼¤Ë°Í¸¤¹¤ë¡£
+カテゴリーに依存する。
 .PP
-¤³¤Î´Ø¿ô¤Ï»ÈÍѤµ¤ì¤ë¤Ù¤­¤Ç¤Ï¤Ê¤¤¡£¾õÂÖ(state)¤ò»ý¤Ã¤¿¥¨¥ó¥³¡¼¥É¤Ë¤Ï»È¤¨¤º¡¢
-¥Þ¥ë¥Á¥Ð¥¤¥È¥·¡¼¥±¥ó¥¹¤È¤Ï°ã¤¤¡¢É¬¤º¤·¤â¥·¥ó¥°¥ë¥Ð¥¤¥È
-¤ò¼è¤ê°·¤¨¤ë¤È¤Ï¸Â¤é¤Ê¤¤¡£Âå¤ï¤ê¤Ë
+この関数は使用されるべきではない。状態(state)を持ったエンコードには使えず、
+マルチバイトシーケンスとは違い、必ずしもシングルバイト
+を取り扱えるとは限らない。代わりに
 .BR mbtowc ()
-¤«¡¢¥¹¥ì¥Ã¥É¥»¡¼¥Õ¤Ê
+か、スレッドセーフな
 .BR mbrtowc ()
-¤ò»ÈÍѤ¹¤ë¤³¤È¡£
-.SH ´ØÏ¢¹àÌÜ
+を使用すること。
+.SH 関連項目
 .BR mbtowc (3),
 .BR mbrtowc (3),
 .BR wctob (3)