.SH 説明
この関数が用いられる場合、通常 \fIs\fP が NULL でなく \fIpwc\fP も NULL でない。この場合は \fBmbtowc\fP() 関数は
\fIs\fP から始まる 最大 \fIn\fP バイトのマルチバイト文字列を検査して、次の完全なマルチバイト 文字を取り出し、それをワイド文字に変換して
-\fI*pwc\fP に格納する。 同時に mbtowc 関数のみが使用する内部状態を更新する。\fIs\fP が NULL バイト (\(aq\e0\(aq)
-以外を指している場合は、\fIs\fP から消費するバイト数を返す。 \fIs\fP が NULL バイトを指している場合には 0 を返す。
+\fI*pwc\fP に格納する。 同時に mbtowc 関数のみが使用する内部状態を更新する。\fIs\fP がヌルバイト (\(aq\e0\(aq)
+以外を指している場合は、\fIs\fP から消費するバイト数を返す。 \fIs\fP がヌルバイトを指している場合には 0 を返す。
.PP
\fIs\fP から始まる \fIn\fP バイトが完全なマルチバイト文字を含んで いない場合や不正なマルチバイト列を含んでいる場合には \fBmbtowc\fP()
は \-1 を返す。マルチバイト文字列に冗長なシフトシーケンスが 含まれていると \fIn\fP >= \fIMB_CUR_MAX\fP
三番目の場合として \fIs\fP が NULL の場合は \fIpwc\fP と \fIn\fP は 無視される。 \fBmbtowc\fP()
関数のみが使用するシフト状態は初期状態に 戻される。そして文字符号がシフト状態に依存するならばゼロ以外を、文字符号が 状態によらないならばゼロを返す。
.SH 返り値
-\fIs\fP ã\81\8c NULL ã\81§ã\81ªã\81\91ã\82\8cã\81° \fBmbtowc\fP() é\96¢æ\95°ã\81¯ \fIs\fP ã\81\8bã\82\89æ¶\88è²»ã\81\97ã\81\9f ã\83\90ã\82¤ã\83\88æ\95°ã\82\92ã\80\81\fIs\fP ã\81\8cã\83\8aル文字を指している場合はゼロを、
+\fIs\fP ã\81\8c NULL ã\81§ã\81ªã\81\91ã\82\8cã\81° \fBmbtowc\fP() é\96¢æ\95°ã\81¯ \fIs\fP ã\81\8bã\82\89æ¶\88è²»ã\81\97ã\81\9f ã\83\90ã\82¤ã\83\88æ\95°ã\82\92ã\80\81\fIs\fP ã\81\8cã\83\8cル文字を指している場合はゼロを、
変換に失敗した場合は \-1 を返す。
.PP
\fIs\fP が NULL ならば \fBmbtowc\fP() 関数は文字符号がシフト状態に依存 していればゼロ以外を、状態によらなければゼロを返す。
\fBMB_CUR_MAX\fP(3), \fBmblen\fP(3), \fBmbrtowc\fP(3), \fBmbstowcs\fP(3), \fBwctomb\fP(3),
\fBwcstombs\fP(3)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.64 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.67 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
