.\"
.TH MBSRTOWCS 3 2011-09-28 "GNU" "Linux Programmer's Manual"
.\"O .SH NAME
-.SH ̾Á°
+.SH 名前
.\"O mbsrtowcs \- convert a multibyte string to a wide-character string
-mbsrtowcs \- ¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎó¤ò¥ï¥¤¥Éʸ»úÎó¤ËÊÑ´¹¤¹¤ë
+mbsrtowcs \- マルチバイト文字列をワイド文字列に変換する
.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.SH 書式
.nf
.B #include <wchar.h>
.sp
.BI " size_t " len ", mbstate_t *" ps );
.fi
.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
+.SH 説明
.\"O If \fIdest\fP is not a NULL pointer, the
.\"O .BR mbsrtowcs ()
.\"O function converts the
.\"O positive number, as long as this call succeeds, and then incrementing
.\"O \fIdest\fP by one and \fI*src\fP by the number of bytes consumed.
.\"O The conversion can stop for three reasons:
-\fIdest\fP ¤¬ NULL ¥Ý¥¤¥ó¥¿¡¼¤Ç¤Ê¤±¤ì¤Ð¡¢
+\fIdest\fP が NULL ポインターでなければ、
.BR mbsrtowcs ()
-´Ø¿ô¤Ï
-¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎó \fI*src\fP ¤ò \fIdest\fP ¤«¤é»Ï¤Þ¤ë¥ï¥¤¥Éʸ»úÎó¤Ë
-ÊÑ´¹¤¹¤ë¡£\fIdest\fP ¤Ë¤ÏºÇÂç¤Ç \fIlen\fP ʸ»ú¤Î¥ï¥¤¥Éʸ»ú¤¬
-½ñ¤¹þ¤Þ¤ì¤ë¡£Æ±»þ¤Ë¥·¥Õ¥È¾õÂÖ \fI*ps\fP ¤ò¹¹¿·¤¹¤ë¡£
-ÊÑ´¹¤Ï
+関数は
+マルチバイト文字列 \fI*src\fP を \fIdest\fP から始まるワイド文字列に
+変換する。\fIdest\fP には最大で \fIlen\fP 文字のワイド文字が
+書き込まれる。同時にシフト状態 \fI*ps\fP を更新する。
+変換は
.I "mbrtowc(dest, *src, n, ps)"
-¤ò¡¢¤³¤Î¸Æ¤Ó½Ð¤·¤¬À®¸ù¤¹¤ë¸Â¤ê·«¤êÊÖ¤·¼Â¹Ô¤·¤¿¤Î¤È¼Â¼ÁŪ¤ËƱÍͤǤ¢¤ë¡£
-¤³¤³¤Ç \fIn\fP ¤ÏÀµ¤Î¿ô¤Ç¤¢¤ê¡¢·«¤êÊÖ¤·¤´¤È¤Ë \fIdest\fP ¤¬ 1 Áý²Ã¤µ¤»¤é¤ì¡¢
-\fI*src\fP ¤¬¾ÃÈñ¤·¤¿¥Ð¥¤¥È¿ô¤À¤±Áý²Ã¤µ¤»¤é¤ì¤ë¡£ÊÑ´¹¤Ï°Ê²¼¤Î»°¤Ä¤Î
-¤¤¤º¤ì¤«¤Î¾ò·ï¤ÇÄä»ß¤¹¤ë:
+を、この呼び出しが成功する限り繰り返し実行したのと実質的に同様である。
+ここで \fIn\fP は正の数であり、繰り返しごとに \fIdest\fP が 1 増加させられ、
+\fI*src\fP が消費したバイト数だけ増加させられる。変換は以下の三つの
+いずれかの条件で停止する:
.IP 1. 3
.\"O An invalid multibyte sequence has been encountered.
.\"O In this case \fI*src\fP
.\"O .I (size_t)\ \-1
.\"O is returned,
.\"O and \fIerrno\fP is set to \fBEILSEQ\fP.
-ÉÔÀµ¤Ê¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ËÁø¶ø¤·¤¿¡£¤³¤Î¾ì¹ç¤Ë¤Ï \fI*src\fP ¤ÏÉÔÀµ¤Ê
-¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ò»Ø¤¹¤è¤¦¤Ë¤·¤Æ¡¢
+不正なマルチバイト列に遭遇した。この場合には \fI*src\fP は不正な
+マルチバイト列を指すようにして、
.I (size_t)\ \-1
-¤òÊÖ¤·¡¢\fIerrno\fP ¤Ë \fBEILSEQ\fP ¤òÀßÄꤹ¤ë¡£
+を返し、\fIerrno\fP に \fBEILSEQ\fP を設定する。
.IP 2.
.\"O \fIlen\fP non-L\(aq\\0\(aq wide characters have been stored at \fIdest\fP.
.\"O In this
.\"O case \fI*src\fP is left pointing to the next
.\"O multibyte sequence to be converted,
.\"O and the number of wide characters written to \fIdest\fP is returned.
-\fIlen\fP ʸ»ú¤Î L\(aq\\0\(aq °Ê³°¤Î¥ï¥¤¥Éʸ»ú¤ò \fIdest\fP ¤Ë³ÊǼ¤·¤¿¾ì¹ç¡£
-¤³¤Î¾ì¹ç¤Ï \fI*src\fP ¤Ï¼¡¤ËÊÑ´¹¤µ¤ì¤ë¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ò»Ø¤¹¤è¤¦¤Ë¤·¤Æ¡¢
-\fIdest\fP ¤Ë½ñ¤¹þ¤Þ¤ì¤¿¥ï¥¤¥Éʸ»ú¤Î¿ô¤òÊÖ¤¹¡£
+\fIlen\fP 文字の L\(aq\\0\(aq 以外のワイド文字を \fIdest\fP に格納した場合。
+この場合は \fI*src\fP は次に変換されるマルチバイト列を指すようにして、
+\fIdest\fP に書き込まれたワイド文字の数を返す。
.IP 3.
.\"O The multibyte string has been completely converted, including the
.\"O terminating null wide character (\(aq\\0\(aq), which has the side
.\"O In this case \fI*src\fP is set to NULL, and the number of wide
.\"O characters written to \fIdest\fP,
.\"O excluding the terminating null wide character, is returned.
-¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎ󤬽ªÃ¼¤Î NULL ¥ï¥¤¥Éʸ»ú (\(aq\\0\(aq) ¤Þ¤Ç´Þ¤á¤Æ´°Á´¤Ë
-ÊÑ´¹¤µ¤ì¤¿¾ì¹ç¡£¤³¤Î»þ¡¢ÉûºîÍѤȤ·¤Æ \fI*ps\fP ¤¬½é´ü¾õÂÖ¤ËÌᤵ¤ì¤ë¡£
-¤³¤Î¾ì¹ç¤Ï \fI*src\fP ¤Ë¤Ï NULL ¤¬ÀßÄꤵ¤ì¡¢½ªÃ¼¤Î NULL ¥ï¥¤¥Éʸ»ú¤ò½ü¤¤¤Æ
-\fIdest\fP ¤Ë½ñ¤¹þ¤Þ¤ì¤¿Ê¸»ú¿ô¤òÊÖ¤¹¡£
+マルチバイト文字列が終端の NULL ワイド文字 (\(aq\\0\(aq) まで含めて完全に
+変換された場合。この時、副作用として \fI*ps\fP が初期状態に戻される。
+この場合は \fI*src\fP には NULL が設定され、終端の NULL ワイド文字を除いて
+\fIdest\fP に書き込まれた文字数を返す。
.PP
.\"O If \fIdest\fP is NULL, \fIlen\fP is ignored,
.\"O and the conversion proceeds as above,
.\"O except that the converted wide characters are not written out to memory,
.\"O and that no length limit exists.
-\fIdest\fP ¤¬ NULL ¤Î¾ì¹ç¡¢\fIlen\fP ¤Ï̵»ë¤µ¤ì¡¢¾åµ¤ÈƱÍͤÎÊÑ´¹¤¬
-¹Ô¤ï¤ì¤ë¤¬¡¢ÊÑ´¹¤µ¤ì¤¿¥ï¥¤¥Éʸ»ú¤Ï¥á¥â¥ê¤Ë½ñ¤¹þ¤Þ¤ì¤º¡¢ÊÑ´¹Àè¤Î¾å¸Â
-¤¬Â¸ºß¤·¤Ê¤¤¡£
+\fIdest\fP が NULL の場合、\fIlen\fP は無視され、上記と同様の変換が
+行われるが、変換されたワイド文字はメモリに書き込まれず、変換先の上限
+が存在しない。
.PP
.\"O In both of the above cases,
.\"O if \fIps\fP is a NULL pointer, a static anonymous
.\"O state only known to the
.\"O .BR mbsrtowcs ()
.\"O function is used instead.
-¾åµ¤Î¤É¤Á¤é¤Î¾ì¹ç¤Ç¤â¡¢\fIps\fP ¤¬ NULL ¥Ý¥¤¥ó¥¿¡¼¤Ê¤é¤Ð¡¢
-Âå¤ê¤Ë
+上記のどちらの場合でも、\fIps\fP が NULL ポインターならば、
+代りに
.BR mbsrtowcs ()
-´Ø¿ô¤Î¤ß¤¬»ÈÍѤ¹¤ëÀÅŪ¤Ç̾Á°¤Î¤Ê¤¤¾õÂÖ¤¬»ÈÍѤµ¤ì¤ë¡£
+関数のみが使用する静的で名前のない状態が使用される。
.PP
.\"O The programmer must ensure that there is room for at least \fIlen\fP wide
.\"O characters at \fIdest\fP.
-¥×¥í¥°¥é¥Þ¡¼¤Ï \fIdest\fP ¤ËºÇÄã¤Ç¤â \fIlen\fP ¥ï¥¤¥Éʸ»ú¤ò½ñ¤¹þ¤à¤³
-¤È¤¬¤Ç¤¤ë¶õ´Ö¤¬¤¢¤ë¤³¤È¤òÊݾڤ·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
+プログラマーは \fIdest\fP に最低でも \fIlen\fP ワイド文字を書き込むこ
+とができる空間があることを保証しなければならない。
.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
+.SH 返り値
.\"O The
.\"O .BR mbsrtowcs ()
.\"O function returns the number of wide characters that make
.\"O .I (size_t)\ \-1
.\"O is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.BR mbsrtowcs ()
-´Ø¿ô¤Ï¥ï¥¤¥Éʸ»úÎó¤ËÊÑ´¹´°Î»¤·¤¿¥ï¥¤¥Éʸ»ú¤Î¿ô¤òÊÖ¤¹¡£
-½ªÃ¼¤Î¥Ê¥ë¥ï¥¤¥Éʸ»ú¤Ï´Þ¤Þ¤Ê¤¤¡£ÉÔÀµ¤Ê¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ËÁø¶ø¤·¤¿¾ì¹ç¤Ë¤Ï
+関数はワイド文字列に変換完了したワイド文字の数を返す。
+終端のナルワイド文字は含まない。不正なマルチバイト列に遭遇した場合には
.I (size_t)\ \-1
-¤òÊÖ¤·¡¢\fIerrno\fP ¤Ë \fBEILSEQ\fP ¤òÀßÄꤹ¤ë¡£
+を返し、\fIerrno\fP に \fBEILSEQ\fP を設定する。
.\"O .SH "CONFORMING TO"
-.SH ½àµò
+.SH 準拠
C99.
.\"O .SH NOTES
-.SH Ãí°Õ
+.SH 注意
.\"O The behavior of
.\"O .BR mbsrtowcs ()
.\"O depends on the
.\"O category of the
.\"O current locale.
.BR mbsrtowcs ()
-¤ÎÆ°ºî¤Ï¸½ºß¤Î¥í¥±¡¼¥ë¤Î
+の動作は現在のロケールの
.B LC_CTYPE
-¥«¥Æ¥´¥ê¤Ë°Í¸¤·¤Æ¤¤¤ë¡£
+カテゴリに依存している。
.PP
.\"O Passing NULL as \fIps\fP is not multithread safe.
-\fIps\fP ¤È¤·¤Æ NULL ¤òÅϤ¹¤³¤È¤Ï¥Þ¥ë¥Á¥¹¥ì¥Ã¥É¤Ç¤Ï°ÂÁ´¤Ç¤Ê¤¤¡£
+\fIps\fP として NULL を渡すことはマルチスレッドでは安全でない。
.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR iconv (3),
.BR mbsnrtowcs (3),
.BR mbstowcs (3)
OSDN Git Service
