bf45b11e784ac0d715613b168dce44c20f33ee80
[scilab.git] / scilab / modules / string / help / ja_JP / strsplit.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) INRIA - 
5  * 
6  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at    
10  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
11  *
12  -->
13 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="strsplit" xml:lang="ja">
14     <refnamediv>
15         <refname>strsplit</refname>
16         <refpurpose>文字列を文字列のベクトルに分割する</refpurpose>
17     </refnamediv>
18     <refsynopsisdiv>
19         <title>呼び出し手順</title>
20         <synopsis>
21             v = strsplit(str,ind)
22             [v, matched_separators] = strsplit(str)
23             [v, matched_separators] = strsplit(str, matrix_of_strings, limit)
24             [v, matched_separators] = strsplit(str, regexp_pattern, limit)
25         </synopsis>
26     </refsynopsisdiv>
27     <refsection>
28         <title>パラメータ</title>
29         <variablelist>
30             <varlistentry>
31                 <term>str</term>
32                 <listitem>
33                     <para>分割する文字列</para>
34                 </listitem>
35             </varlistentry>
36             <varlistentry>
37                 <term>ind</term>
38                 <listitem>
39                     <para>
40                         <literal>[1 length(str)-1] </literal>の範囲の
41                         単調増加のインデックスのベクトル.
42                     </para>
43                 </listitem>
44             </varlistentry>
45             <varlistentry>
46                 <term>v</term>
47                 <listitem>
48                     <para>得られた文字列の列ベクトル  (次元 &gt;<literal>
49                             size(ind,'*')+1
50                         </literal>
51                         ).
52                     </para>
53                 </listitem>
54             </varlistentry>
55             <varlistentry>
56                 <term>matched_separators</term>
57                 <listitem>
58                     <para>一致したセパレータの列ベクトル</para>
59                 </listitem>
60             </varlistentry>
61             <varlistentry>
62                 <term>matrix_of_strings</term>
63                 <listitem>
64                     <para>strの中で検索する文字列の行列</para>
65                 </listitem>
66             </varlistentry>
67             <varlistentry>
68                 <term>regexp_pattern</term>
69                 <listitem>
70                     <para>正規表現パターン</para>
71                 </listitem>
72             </varlistentry>
73             <varlistentry>
74                 <term>limit</term>
75                 <listitem>
76                     <para>要素数の最大値</para>
77                 </listitem>
78             </varlistentry>
79         </variablelist>
80     </refsection>
81     <refsection>
82         <title>説明</title>
83         <para>
84             <literal>v= strsplit(str, ind)</literal> は,
85             <literal>ind</literal> でインデックスが指定された
86             点(indのインデックスが指す各文字の後)で,
87             文字列を文字列のベクトルに分割します.
88         </para>
89         <para>
90             <literal>strsplit(str)</literal> は,
91             <literal>strsplit(str,1:length(str)-1).</literal>と同じ文字列を返します.
92         </para>
93         <para>
94             <literal>strsplit(str, regexp_pattern, limit)</literal> は
95             文字列の列ベクトルを返します.
96             その各々は,大文字小文字を区別する正規表現により構築された境界で
97             分割されたstr の部分文字列です.
98         </para>
99         <para>パターンがn回現れる場合,
100             返される配列はn+1個の要素を有します.
101         </para>
102         <para>例えば, パターンが1回も存在しなかった場合,
103             1要素のみの配列が返されます.
104             もちろん,これはstrが空の場合も同じです.
105         </para>
106         <para>limitが設定された場合,返される配列には
107             最大limit個の要素が含まれ,
108             その最後の要素には文字列の残り全体が含まれます.
109         </para>
110         <para>
111             <literal>strsplit(str, matrix_of_strings, limit)</literal> , str は
112             要素に分割されます.これにより,
113             正規表現を知らないユーザが異なるセパレータで分割することが
114             できるようになります.
115         </para>
116         <para>
117             <literal>strsplit()</literal> が第2の出力引数を指定してコールされた場合,
118             一致したセパレータの列ベクトルが返されます.
119         </para>
120     </refsection>
121     <refsection>
122         <title>例</title>
123         <programlisting role="example"><![CDATA[ 
124 S='strsplit splits a string into a vector of strings';
125 strsplit(S,[15 25 30])
126 ind=strindex(S,' ')
127 [r_1, r_2] = strsplit("abcd")
128 [r_1, r_2] = strsplit("root:x:0:0:root:/root:/bin/bash",":",5)
129 [r_1, r_2] = strsplit("abc,def:ijk,:lmo","/:|,/")
130 [r_1, r_2] = strsplit("abc,def:ijk,:lmo",[":";","])    
131 strsplit("abcdef2ghijkl3mnopqr6stuvw7xyz","/\d+/") 
132 [r_1, r_2] = strsplit("abcdef2ghijkl3mnopqr6stuvw7xyz","/\d+/",2) 
133  ]]></programlisting>
134     </refsection>
135     <refsection role="see also">
136         <title>参照</title>
137         <simplelist type="inline">
138             <member>
139                 <link linkend="strcat"> strcat</link>
140             </member>
141             <member>
142                 <link linkend="tokens"> tokens</link>
143             </member>
144             <member>
145                 <link linkend="regexp"> regexp</link>
146             </member>
147         </simplelist>
148     </refsection>
149 </refentry>