+.\" t -*- coding: UTF-8 -*-
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
+.\" and Copyright 2014 Michael Kerrisk <mtk.manpages@gmail.com>
.\"
+.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
+.\" %%%LICENSE_END
.\"
.\" References consulted:
.\" GNU glibc-2 source code and manual
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
-.TH MBSTOWCS 3 2011\-09\-28 GNU "Linux Programmer's Manual"
+.\"
+.\" Japanese Version Copyright (c) 1999 HANATAKA Shinya
+.\" all rights reserved.
+.\" Translated Tue Jan 11 00:56:04 JST 2000
+.\" by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
+.\"
+.TH MBSTOWCS 3 2014\-03\-18 GNU "Linux Programmer's Manual"
.SH 名前
mbstowcs \- マルチバイト文字列をワイド文字列に変換する
.SH 書式
\fBsize_t mbstowcs(wchar_t *\fP\fIdest\fP\fB, const char *\fP\fIsrc\fP\fB, size_t \fP\fIn\fP\fB);\fP
.fi
.SH 説明
-\fIdest\fP ã\81\8c NULL ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\81§ã\81ªã\81\91ã\82\8cã\81° \fBmbstowcs\fP() é\96¢æ\95°ã\81¯ ã\83\9eã\83«ã\83\81ã\83\90ã\82¤ã\83\88æ\96\87å\97å\88\97 \fI*src\fP ã\82\92 \fIdest\fP
+\fIdest\fP が NULL でなければ \fBmbstowcs\fP() 関数は マルチバイト文字列 \fI*src\fP を \fIdest\fP
から始まるワイド文字列に 変換する。\fIdest\fP には最大で \fIn\fP 文字のワイド文字が 書き込まれる。変換は初期状態で開始され、
以下の三つのいずれかの条件で停止する:
.IP 1. 3
\fIn\fP 文字の L\(aq\e0\(aq 以外のワイド文字を \fIdest\fP に格納した場合。 この場合は \fI*src\fP
が次に変換されるマルチバイト列を指すようにして、 \fIdest\fP に書き込まれたワイド文字の数を返す。しかしこの指している 場所のシフト状態は失われる。
.IP 3.
-マルチバイト文字列が終端の NULL ワイド文字 (\(aq\e0\(aq) まで含めて完全に 変換された場合。この場合は終端の NULL
-ワイド文字を除いて \fIdest\fP に書き込まれた文字数を返す。
+マルチバイト文字列が終端のヌルワイド文字 (\(aq\e0\(aq) まで含めて完全に 変換された場合。この場合は終端のヌルワイド文字を除いて
+\fIdest\fP に書き込まれた文字数を返す。
.PP
プログラマーは \fIdest\fP に最低でも \fIn\fP ワイド文字を書き込むこ とができる空間があることを保証しなければならない。
.PP
-\fIdest\fP が NULL の場合、\fIn\fP は無視され、上記と同様の変換が 行われるが、変換されたワイド文字はメモリに書き込まれず、変換先の上限
+\fIdest\fP ã\81\8c NULL ã\81®å ´å\90\88ã\80\81\fIn\fP ã\81¯ç\84¡è¦\96ã\81\95ã\82\8cã\80\81ä¸\8aè¨\98ã\81¨å\90\8cæ§\98ã\81®å¤\89æ\8f\9bã\81\8c è¡\8cã\82\8fã\82\8cã\82\8bã\81\8cã\80\81å¤\89æ\8f\9bã\81\95ã\82\8cã\81\9fã\83¯ã\82¤ã\83\89æ\96\87å\97ã\81¯ã\83¡ã\83¢ã\83ªã\83¼ã\81«æ\9b¸ã\81\8dè¾¼ã\81¾ã\82\8cã\81\9aã\80\81å¤\89æ\8f\9bå\85\88ã\81®ä¸\8aé\99\90
が存在しない。
.PP
上記の 2. の場合を避けるためにプログラマーは \fIn\fP が \fImbstowcs(NULL,src,0)+1\fP 以上であることを保証すべきである。
.SH 返り値
\fBmbstowcs\fP() 関数はワイド文字列に変換完了したワイド文字の数を返す。
-çµ\82端ã\81®ã\83\8aルワイド文字は含まない。不正なマルチバイト列に遭遇した場合には \fI(size_t)\ \-1\fP を返す。
+çµ\82端ã\81®ã\83\8cルワイド文字は含まない。不正なマルチバイト列に遭遇した場合には \fI(size_t)\ \-1\fP を返す。
.SH 準拠
C99.
.SH 注意
-\fBmbstowcs\fP() の動作は現在のロケールの \fBLC_CTYPE\fP カテゴリに依存している。
+\fBmbstowcs\fP() ã\81®å\8b\95ä½\9cã\81¯ç\8f¾å\9c¨ã\81®ã\83ã\82±ã\83¼ã\83«ã\81® \fBLC_CTYPE\fP ã\82«ã\83\86ã\82´ã\83ªã\83¼ã\81«ä¾\9då\98ã\81\97ã\81¦ã\81\84ã\82\8bã\80\82
.PP
\fBmbsrtowcs\fP(3) 関数は同じ機能のより良いインターフェースを提供する。
+.SH 例
+下記のプログラムは \fBmbstowcs\fP() といくつかのワイド文字分類関数の使用方法を示したものである。実行例は以下のようになる。
+.in +4n
+.nf
+
+$ ./t_mbstowcs de_DE.UTF\-8 Grüße!
+Length of source string (excluding terminator):
+ 8 bytes
+ 6 multibyte characters
+
+Wide character string is: Grüße! (6 characters)
+ G alpha upper
+ r alpha lower
+ ü alpha lower
+ ß alpha lower
+ e alpha lower
+ ! !alpha
+.fi
+.in
+.SS プログラムのソース
+.nf
+#include <locale.h>
+#include <wchar.h>
+#include <stdio.h>
+#include <string.h>
+#include <stdlib.h>
+
+int
+main(int argc, char *argv[])
+{
+ size_t mbslen; /* Number of multibyte characters in source */
+ wchar_t *wcs; /* Pointer to converted wide character string */
+ wchar_t *wp;
+
+ if (argc < 3) {
+ fprintf(stderr, "Usage: %s <locale> <string>\en", argv[0]);
+ exit(EXIT_FAILURE);
+ }
+
+ /* Apply the specified locale */
+
+ if (setlocale(LC_ALL, argv[1]) == NULL) {
+ perror("setlocale");
+ exit(EXIT_FAILURE);
+ }
+
+ /* Calculate the length required to hold argv[2] converted to
+ a wide character string */
+
+ mbslen = mbstowcs(NULL, argv[2], 0);
+ if (mbslen == (size_t) \-1) {
+ perror("mbstowcs");
+ exit(EXIT_FAILURE);
+ }
+
+ /* Describe the source string to the user */
+
+ printf("Length of source string (excluding terminator):\en");
+ printf(" %zu bytes\en", strlen(argv[2]));
+ printf(" %zu multibyte characters\en\en", mbslen);
+
+ /* Allocate wide character string of the desired size. Add 1
+ to allow for terminating null wide character (L\(aq\e0\(aq). */
+
+ wcs = calloc(mbslen + 1, sizeof(wchar_t));
+ if (wcs == NULL) {
+ perror("calloc");
+ exit(EXIT_FAILURE);
+ }
+
+ /* Convert the multibyte character string in argv[2] to a
+ wide character string */
+
+ if (mbstowcs(wcs, argv[2], mbslen + 1) == (size_t) \-1) {
+ perror("mbstowcs");
+ exit(EXIT_FAILURE);
+ }
+
+ printf("Wide character string is: %ls (%zu characters)\en",
+ wcs, mbslen);
+
+ /* Now do some inspection of the classes of the characters in
+ the wide character string */
+
+ for (wp = wcs; *wp != 0; wp++) {
+ printf(" %lc ", (wint_t) *wp);
+
+ if (!iswalpha(*wp))
+ printf("!");
+ printf("alpha ");
+
+ if (iswalpha(*wp)) {
+ if (iswupper(*wp))
+ printf("upper ");
+
+ if (iswlower(*wp))
+ printf("lower ");
+ }
+
+ putchar(\(aq\en\(aq);
+ }
+
+ exit(EXIT_SUCCESS);
+}
+.fi
.SH 関連項目
-\fBmbsrtowcs\fP(3), \fBwcstombs(3)\fP
+\fBmblen\fP(3), \fBmbsrtowcs\fP(3), \fBmbtowc\fP(3), \fBwctomb\fP(3), \fBwcstombs\fP(3)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.40 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.78 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。