path: root/modules/string/help/ja_JP/strsplit.xml

<?xml version="1.0" encoding="UTF-8"?>

<!--
 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) INRIA - 
 * 
 * This file must be used under the terms of the CeCILL.
 * This source file is licensed as described in the file COPYING, which
 * you should have received as part of this distribution.  The terms
 * are also available at    
 * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
 *
 -->

<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">
    
    <refnamediv>
        
        <refname>strsplit</refname>
        
        <refpurpose>文字列を文字列のベクトルに分割する</refpurpose>
        
    </refnamediv>
    
    <refsynopsisdiv>
        
        <title>呼び出し手順</title>
        
        <synopsis>
            
            v = strsplit(str,ind)
            
            [v, matched_separators] = strsplit(str)
            
            [v, matched_separators] = strsplit(str, matrix_of_strings, limit)
            
            [v, matched_separators] = strsplit(str, regexp_pattern, limit)
            
        </synopsis>
        
    </refsynopsisdiv>
    
    <refsection>
        
        <title>引数</title>
        
        <variablelist>
            
            <varlistentry>
                
                <term>str</term>
                
                <listitem>
                    
                    <para>分割する文字列</para>
                    
                </listitem>
                
            </varlistentry>
            
            <varlistentry>
                
                <term>ind</term>
                
                <listitem>
                    
                    <para>
                        
                        <literal>[1 length(str)-1] </literal>の範囲の
                        
                        単調増加のインデックスのベクトル.
                        
                    </para>
                    
                </listitem>
                
            </varlistentry>
            
            <varlistentry>
                
                <term>v</term>
                
                <listitem>
                    
                    <para>
                        
                        得られた文字列の列ベクトル (次元 
                        
                        &gt;<literal>size(ind,'*')+1</literal>).
                        
                    </para>
                    
                </listitem>
                
            </varlistentry>
            
            <varlistentry>
                
                <term>matched_separators</term>
                
                <listitem>
                    
                    <para>一致したセパレータの列ベクトル</para>
                    
                </listitem>
                
            </varlistentry>
            
            <varlistentry>
                
                <term>matrix_of_strings</term>
                
                <listitem>
                    
                    <para>strの中で検索する文字列の行列</para>
                    
                </listitem>
                
            </varlistentry>
            
            <varlistentry>
                
                <term>regexp_pattern</term>
                
                <listitem>
                    
                    <para>正規表現パターン</para>
                    
                </listitem>
                
            </varlistentry>
            
            <varlistentry>
                
                <term>limit</term>
                
                <listitem>
                    
                    <para>要素数の最大値</para>
                    
                </listitem>
                
            </varlistentry>
            
        </variablelist>
        
    </refsection>
    
    <refsection>
        
        <title>説明</title>
        
        <para>
            
            <code>v= strsplit(str, ind)</code>は,文字列<varname>str</varname>を
            
            <varname>ind</varname>で添字が指定された点
            
            (<varname>ind</varname>の添字が指す各文字の後)で,
            
            文字列のベクトルに分割します.
            
        </para>
        
        <para>
            
            <code>strsplit(str)</code> は,
            
            <code>strsplit(str,1:length(str)-1)</code>と同じ文字列を返します.
            
        </para>
        
        <para>
            
            <code>strsplit(str, regexp_pattern, limit)</code>は
            
            文字列の列ベクトルを返します.
            
            その各々は,大文字小文字を区別する正規表現により構築された境界で
            
            分割された<varname>str</varname> の部分文字列です.
            
        </para>
        
        <para>
            
            パターンが<literal>n</literal>回現れる場合,
            
            返される配列は<literal>n+1</literal>個の要素を有します.
            
        </para>
        
        <para>
            
            例えば, パターンが1回も存在しなかった場合,
            
            1要素のみの配列が返されます.
            
            もちろん,これは<varname>str</varname>が空の場合も同じです.
            
        </para>
        
        <para>
            
            <varname>limit</varname>が設定された場合,返される配列には
            
            最大<varname>limit</varname>個の要素が含まれ,
            
            その最後の要素には文字列の残り全体が含まれます.
            
        </para>
        
        <para>
            
            <code>strsplit(str, matrix_of_strings, limit)</code>は,
            
            <varname>str</varname>を任意の要素で分割します.
            
            これにより,
            
            正規表現を知らないユーザが異なるセパレータで分割することが
            
            できるようになります.
            
        </para>
        
        <para>
            
            <code>strsplit()</code>が第2の出力引数を指定してコールされた場合,
            
            一致したセパレータの列ベクトルが返されます.
            
        </para>
        
    </refsection>
    
    <refsection>
        
        <title>例</title>
        
        <programlisting role="example"><![CDATA[ 
S='strsplit splits a string into a vector of strings';
strsplit(S,[15 25 30])
ind=strindex(S,' ')
[r_1, r_2] = strsplit("abcd")
[r_1, r_2] = strsplit("root:x:0:0:root:/root:/bin/bash",":",5)
[r_1, r_2] = strsplit("abc,def:ijk,:lmo","/:|,/")
[r_1, r_2] = strsplit("abc,def:ijk,:lmo",[":";","])    
strsplit("abcdef2ghijkl3mnopqr6stuvw7xyz","/\d+/") 
[r_1, r_2] = strsplit("abcdef2ghijkl3mnopqr6stuvw7xyz","/\d+/",2) 
 ]]></programlisting>
        
    </refsection>
    
    <refsection role="see also">
        
        <title>参照</title>
        
        <simplelist type="inline">
            
            <member>
                
                <link linkend="part"> part</link>
                
            </member>
            
            <member>
                
                <link linkend="strcat"> strcat</link>
                
            </member>
            
            <member>
                
                <link linkend="tokens"> tokens</link>
                
            </member>
            
            <member>
                
                <link linkend="regexp"> regexp</link>
                
            </member>
            
        </simplelist>
        
    </refsection>
    
</refentry>