.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
+.\" %%%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
.\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\" ISO/IEC 9899:1999
.\"
-.\" About this Japanese page, please contact to JM Project <JM@linux.or.jp>
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.\"
.\" Translated Sat Oct 23 17:53:50 JST 1999
.\" by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
-.TH WCSTOK 3 2011-09-28 "GNU" "Linux Programmer's Manual"
-.SH ̾Á°
-wcstok \- ¥ï¥¤¥Éʸ»úʸ»úÎó¤ò¥È¡¼¥¯¥ó¤Ëʬ³ä¤¹¤ë
-.SH ½ñ¼°
+.TH WCSTOK 3 2011\-09\-28 GNU "Linux Programmer's Manual"
+.SH 名前
+wcstok \- ワイド文字文字列をトークンに分割する
+.SH 書式
.nf
-.B #include <wchar.h>
+\fB#include <wchar.h>\fP
.sp
-.BI "wchar_t *wcstok(wchar_t *" wcs ", const wchar_t *" delim \
-", wchar_t **" ptr );
+\fBwchar_t *wcstok(wchar_t *\fP\fIwcs\fP\fB, const wchar_t *\fP\fIdelim\fP\fB, wchar_t **\fP\fIptr\fP\fB);\fP
.fi
-.SH ÀâÌÀ
-.BR wcstok ()
-´Ø¿ô¤Ï¡¢
-.BR strtok (3)
-´Ø¿ô¤ËÂбþ¤¹¤ë¥ï¥¤¥Éʸ»ú´Ø¿ô¤Ë¡¢
-¥Þ¥ë¥Á¥¹¥ì¥Ã¥É¥»¡¼¥Õ¤ÎÆ°ºî¤ò¤µ¤»¤ë¤¿¤á¤Î°ú¤¿ô¤òÄɲä·¤¿¤â¤Î¤Ç¤¢¤ë¡£
-¤³¤Î´Ø¿ô¤òÍѤ¤¤Æ¡¢¥ï¥¤¥Éʸ»úʸ»úÎó \fIwcs\fP ¤ò¥È¡¼¥¯¥ó¤Ëʬ²ò¤¹¤ë¤³¤È
-¤¬¤Ç¤¤ë¡£¤³¤³¤Ç¡¢¥È¡¼¥¯¥ó¤Ï \fIdelim\fP ¤ËÎóµó¤µ¤ì¤Æ¤¤¤ëʸ»ú¤ò´Þ¤Þ¤Ê
-¤¤Éôʬʸ»úÎó¤È¤·¤ÆÄêµÁ¤µ¤ì¤ë¡£
+.SH 説明
+\fBwcstok\fP() 関数は、 \fBstrtok\fP(3) 関数に対応するワイド文字関数に、
+マルチスレッドセーフの動作をさせるための引き数を追加したものである。 この関数を用いて、ワイド文字文字列 \fIwcs\fP をトークンに分解すること
+ができる。ここで、トークンは \fIdelim\fP に列挙されている文字を含まな い部分文字列として定義される。
.PP
-¸¡º÷¤Ï \fIwcs\fP ¤¬ NULL ¤Ç¤Ê¤±¤ì¤Ð \fIwcs\fP ¤«¤é³«»Ï¤µ¤ì¡¢\fIwcs\fP
-¤¬ NULL ¤Ê¤é¤Ð \fI*ptr\fP ¤«¤é³«»Ï¤µ¤ì¤ë¡£¤Þ¤º¡¢Á´¤Æ¤Î¶èÀÚ¤ê¥ï¥¤¥Éʸ»ú
-¤¬¥¹¥¥Ã¥×¤µ¤ì¤ë¡£¤Ä¤Þ¤ê¡¢\fIdelim\fP ¤Ë´Þ¤Þ¤ì¤ë¥ï¥¤¥Éʸ»ú¤òĶ¤¨¤ë¤è¤¦
-¤Ë¥Ý¥¤¥ó¥¿¤¬Á°¤Ë¿Ê¤á¤é¤ì¤ë¡£
-¥ï¥¤¥Éʸ»úʸ»úÎó¤Î½ª¤ï¤ê¤Ë㤷¤¿¤é¡¢
-.BR wcstok ()
-¤Ï NULL ¤òÊÖ¤·¤Æ
-¥È¡¼¥¯¥ó¤¬Á´¤¯¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¤³¤È¤ò¼¨¤·¡¢¤³¤Î¸å¤Ë
-.BR wcstok ()
-¤ò¸Æ¤Ó
-½Ð¤·¤Æ¤â NULL ¤¬ÊÖ¤µ¤ì¤ë¤è¤¦¤Ë \fI*ptr\fP ¤ËŬÀÚ¤ÊÃͤòÀßÄꤹ¤ë¡£¤½¤ì
-°Ê³°¤Î¾ì¹ç¤Ë¤Ï¡¢
-.BR wcstok ()
-´Ø¿ô¤Ï¥È¡¼¥¯¥ó¤ÎÀèƬ¤ò¼±Ê̤·¡¢¤³¤ì¤ò»Ø¤¹
-¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£¤¿¤À¤·¤³¤ì¤ò¹Ô¤¦Á°¤Ë¡¢¥È¡¼¥¯¥ó¤Î¸å¤Ë¤¢¤ë¡¢\fIdelim\fP
-¤Ë´Þ¤Þ¤ì¤Æ¤¤¤ëʸ»ú¤ò NULL ¥ï¥¤¥Éʸ»ú (L\(aq\\0\(aq) ¤ËÃÖ¤´¹¤¨¤ë¤³¤È
-¤Ë¤è¤Ã¤Æ¥È¡¼¥¯¥ó¤ò 0 ¤Ç½ªÃ¼¤µ¤»¤ë¡£¤µ¤é¤Ë \fI*ptr\fP ¤ò¹¹¿·¤·¡¢¸å¤Ç
-.BR wcstok ()
-¤ò¸Æ¤Ó½Ð¤·¤¿
-ºÝ¤Ë¡¢¼±Ê̤µ¤ì¤¿¥È¡¼¥¯¥ó¤Î³¤¤«¤é¸¡º÷¤Ç¤¤ë¤è¤¦¤Ë¤¹¤ë¡£
-.SH ÊÖ¤êÃÍ
-.BR wcstok ()
-´Ø¿ô¤Ï¼¡¤Î¥È¡¼¥¯¥ó¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£¥È¡¼¥¯¥ó¤¬¸«¤Ä¤«¤é
-¤Ê¤±¤ì¤Ð NULL ¤òÊÖ¤¹¡£
-.SH ½àµò
+検索は \fIwcs\fP が NULL でなければ \fIwcs\fP から開始され、\fIwcs\fP が NULL ならば \fI*ptr\fP
+から開始される。まず、全ての区切りワイド文字 がスキップされる。つまり、\fIdelim\fP に含まれるワイド文字を超えるよう にポインタが前に進められる。
+ワイド文字文字列の終わりに達したら、 \fBwcstok\fP() は NULL を返して トークンが全く見つからなかったことを示し、この後に
+\fBwcstok\fP() を呼び 出しても NULL が返されるように \fI*ptr\fP に適切な値を設定する。それ 以外の場合には、
+\fBwcstok\fP() 関数はトークンの先頭を識別し、これを指す ポインタを返す。ただしこれを行う前に、トークンの後にある、\fIdelim\fP
+に含まれている文字を NULL ワイド文字 (L\(aq\e0\(aq) に置き換えること によってトークンを 0 で終端させる。さらに \fI*ptr\fP
+を更新し、後で \fBwcstok\fP() を呼び出した 際に、識別されたトークンの続きから検索できるようにする。
+.SH 返り値
+\fBwcstok\fP() 関数は次のトークンへのポインタを返す。トークンが見つから なければ NULL を返す。
+.SH 準拠
C99.
-.SH Ãí°Õ
-´Ø¿ô¤ËÍ¿¤¨¤¿¥ï¥¤¥Éʸ»úÎó \fIwcs\fP ¤Ï¡¢´Ø¿ô¤ÎÆ°ºî¤Ë¤è¤Ã¤Æ´°Á´¤Ë½ñ¤´¹
-¤¨¤é¤ì¤ë¡£
-.SH Îã
-°Ê²¼¤Î¥³¡¼¥É¤Ï¡¢¥ï¥¤¥Éʸ»úʸ»úÎó¤Ë´Þ¤Þ¤ì¤ë¥È¡¼¥¯¥ó¤ò¼è¤ê½Ð¤·¤Ê¤¬¤é
-¥ë¡¼¥×¤¹¤ë¡£
+.SH 注意
+関数に与えたワイド文字列 \fIwcs\fP は、関数の動作によって完全に書き換 えられる。
+.SH 例
+以下のコードは、ワイド文字文字列に含まれるトークンを取り出しながら ループする。
.sp
.nf
wchar_t *wcs = ...;
wchar_t *token;
wchar_t *state;
-for (token = wcstok(wcs, " \\t\\n", &state);
+for (token = wcstok(wcs, " \et\en", &state);
token != NULL;
- token = wcstok(NULL, " \\t\\n", &state)) {
+ token = wcstok(NULL, " \et\en", &state)) {
...
}
.fi
-.SH ´ØÏ¢¹àÌÜ
-.BR strtok (3),
-.BR wcschr (3)
+.SH 関連項目
+\fBstrtok\fP(3), \fBwcschr\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.54 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
