.\" by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
.\"
.TH MBSTOWCS 3 2011-09-28 "GNU" "Linux Programmer's Manual"
-.SH ̾Á°
-mbstowcs \- ¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎó¤ò¥ï¥¤¥Éʸ»úÎó¤ËÊÑ´¹¤¹¤ë
-.SH ½ñ¼°
+.SH 名前
+mbstowcs \- マルチバイト文字列をワイド文字列に変換する
+.SH 書式
.nf
.B #include <stdlib.h>
.sp
.BI "size_t mbstowcs(wchar_t *" dest ", const char *" src ", size_t " n );
.fi
-.SH ÀâÌÀ
-\fIdest\fP ¤¬ NULL ¥Ý¥¤¥ó¥¿¡¼¤Ç¤Ê¤±¤ì¤Ð
+.SH 説明
+\fIdest\fP が NULL ポインターでなければ
.BR mbstowcs ()
-´Ø¿ô¤Ï
-¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎó \fI*src\fP ¤ò \fIdest\fP ¤«¤é»Ï¤Þ¤ë¥ï¥¤¥Éʸ»úÎó¤Ë
-ÊÑ´¹¤¹¤ë¡£\fIdest\fP ¤Ë¤ÏºÇÂç¤Ç \fIn\fP ʸ»ú¤Î¥ï¥¤¥Éʸ»ú¤¬
-½ñ¤¹þ¤Þ¤ì¤ë¡£ÊÑ´¹¤Ï½é´ü¾õÂ֤dz«»Ï¤µ¤ì¡¢
-°Ê²¼¤Î»°¤Ä¤Î¤¤¤º¤ì¤«¤Î¾ò·ï¤ÇÄä»ß¤¹¤ë:
+関数は
+マルチバイト文字列 \fI*src\fP を \fIdest\fP から始まるワイド文字列に
+変換する。\fIdest\fP には最大で \fIn\fP 文字のワイド文字が
+書き込まれる。変換は初期状態で開始され、
+以下の三つのいずれかの条件で停止する:
.IP 1. 3
-ÉÔÀµ¤Ê¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ËÁø¶ø¤·¤¿¡£¤³¤Î¾ì¹ç¤Ë¤Ï
+不正なマルチバイト列に遭遇した。この場合には
.I (size_t)\ \-1
-¤òÊÖ¤¹¡£
+を返す。
.IP 2.
-\fIn\fP ʸ»ú¤Î L\(aq\\0\(aq °Ê³°¤Î¥ï¥¤¥Éʸ»ú¤ò \fIdest\fP ¤Ë³ÊǼ¤·¤¿¾ì¹ç¡£
-¤³¤Î¾ì¹ç¤Ï \fI*src\fP ¤¬¼¡¤ËÊÑ´¹¤µ¤ì¤ë¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ò»Ø¤¹¤è¤¦¤Ë¤·¤Æ¡¢
-\fIdest\fP ¤Ë½ñ¤¹þ¤Þ¤ì¤¿¥ï¥¤¥Éʸ»ú¤Î¿ô¤òÊÖ¤¹¡£¤·¤«¤·¤³¤Î»Ø¤·¤Æ¤¤¤ë
-¾ì½ê¤Î¥·¥Õ¥È¾õÂ֤ϼº¤ï¤ì¤ë¡£
+\fIn\fP 文字の L\(aq\\0\(aq 以外のワイド文字を \fIdest\fP に格納した場合。
+この場合は \fI*src\fP が次に変換されるマルチバイト列を指すようにして、
+\fIdest\fP に書き込まれたワイド文字の数を返す。しかしこの指している
+場所のシフト状態は失われる。
.IP 3.
-¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎ󤬽ªÃ¼¤Î NULL ¥ï¥¤¥Éʸ»ú (\(aq\\0\(aq) ¤Þ¤Ç´Þ¤á¤Æ´°Á´¤Ë
-ÊÑ´¹¤µ¤ì¤¿¾ì¹ç¡£¤³¤Î¾ì¹ç¤Ï½ªÃ¼¤Î NULL ¥ï¥¤¥Éʸ»ú¤ò½ü¤¤¤Æ
-\fIdest\fP ¤Ë½ñ¤¹þ¤Þ¤ì¤¿Ê¸»ú¿ô¤òÊÖ¤¹¡£
+マルチバイト文字列が終端の NULL ワイド文字 (\(aq\\0\(aq) まで含めて完全に
+変換された場合。この場合は終端の NULL ワイド文字を除いて
+\fIdest\fP に書き込まれた文字数を返す。
.PP
-¥×¥í¥°¥é¥Þ¡¼¤Ï \fIdest\fP ¤ËºÇÄã¤Ç¤â \fIn\fP ¥ï¥¤¥Éʸ»ú¤ò½ñ¤¹þ¤à¤³
-¤È¤¬¤Ç¤¤ë¶õ´Ö¤¬¤¢¤ë¤³¤È¤òÊݾڤ·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
+プログラマーは \fIdest\fP に最低でも \fIn\fP ワイド文字を書き込むこ
+とができる空間があることを保証しなければならない。
.PP
-\fIdest\fP ¤¬ NULL ¤Î¾ì¹ç¡¢\fIn\fP ¤Ï̵»ë¤µ¤ì¡¢¾åµ¤ÈƱÍͤÎÊÑ´¹¤¬
-¹Ô¤ï¤ì¤ë¤¬¡¢ÊÑ´¹¤µ¤ì¤¿¥ï¥¤¥Éʸ»ú¤Ï¥á¥â¥ê¤Ë½ñ¤¹þ¤Þ¤ì¤º¡¢ÊÑ´¹Àè¤Î¾å¸Â
-¤¬Â¸ºß¤·¤Ê¤¤¡£
+\fIdest\fP が NULL の場合、\fIn\fP は無視され、上記と同様の変換が
+行われるが、変換されたワイド文字はメモリに書き込まれず、変換先の上限
+が存在しない。
.PP
-¾åµ¤Î 2. ¤Î¾ì¹ç¤òÈò¤±¤ë¤¿¤á¤Ë¥×¥í¥°¥é¥Þ¡¼¤Ï \fIn\fP ¤¬
-\fImbstowcs(NULL,src,0)+1\fP °Ê¾å¤Ç¤¢¤ë¤³¤È¤òÊݾڤ¹¤Ù¤¤Ç¤¢¤ë¡£
-.SH ÊÖ¤êÃÍ
+上記の 2. の場合を避けるためにプログラマーは \fIn\fP が
+\fImbstowcs(NULL,src,0)+1\fP 以上であることを保証すべきである。
+.SH 返り値
.BR mbstowcs ()
-´Ø¿ô¤Ï¥ï¥¤¥Éʸ»úÎó¤ËÊÑ´¹´°Î»¤·¤¿¥ï¥¤¥Éʸ»ú¤Î¿ô¤òÊÖ¤¹¡£
-½ªÃ¼¤Î¥Ê¥ë¥ï¥¤¥Éʸ»ú¤Ï´Þ¤Þ¤Ê¤¤¡£ÉÔÀµ¤Ê¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ËÁø¶ø¤·¤¿¾ì¹ç¤Ë¤Ï
+関数はワイド文字列に変換完了したワイド文字の数を返す。
+終端のナルワイド文字は含まない。不正なマルチバイト列に遭遇した場合には
.I (size_t)\ \-1
-¤òÊÖ¤¹¡£
-.SH ½àµò
+を返す。
+.SH 準拠
C99.
-.SH Ãí°Õ
+.SH 注意
.BR mbstowcs ()
-¤ÎÆ°ºî¤Ï¸½ºß¤Î¥í¥±¡¼¥ë¤Î
+の動作は現在のロケールの
.B LC_CTYPE
-¥«¥Æ¥´¥ê¤Ë°Í¸¤·¤Æ¤¤¤ë¡£
+カテゴリに依存している。
.PP
.BR mbsrtowcs (3)
-´Ø¿ô¤ÏƱ¤¸µ¡Ç½¤Î¤è¤êÎɤ¤¥¤¥ó¥¿¡¼¥Õ¥§¡¼¥¹¤òÄ󶡤¹¤ë¡£
-.SH ´ØÏ¢¹àÌÜ
+関数は同じ機能のより良いインターフェースを提供する。
+.SH 関連項目
.BR mbsrtowcs (3),
.BR wcstombs(3)