translation updated for string.
[scilab.git] / scilab / modules / string / help / ja_JP / grep.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <!--
4  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
5  * Copyright (C) INRIA
6  *
7  * This file must be used under the terms of the CeCILL.
8  * This source file is licensed as described in the file COPYING, which
9  * you should have received as part of this distribution.  The terms
10  * are also available at
11  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
12  *
13  -->
14
15 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="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="grep" xml:lang="ja">
16     
17     <refnamediv>
18         
19         <refname>grep</refname>
20         
21         <refpurpose>文字列のベクトルの中で指定した文字列に一致するかどうかを調べる</refpurpose>
22         
23     </refnamediv>
24     
25     <refsynopsisdiv>
26         
27         <title>呼び出し手順</title>
28         
29         <synopsis>row=grep(haystack,needle )
30             
31             [row,which]=grep(haystack,needle )
32             
33             row=grep(haystack,needle ,[flag])
34             
35             [row,which]=grep(haystack,needle ,[flag])
36             
37         </synopsis>
38         
39     </refsynopsisdiv>
40     
41     <refsection>
42         
43         <title>引数</title>
44         
45         <variablelist>
46             
47             <varlistentry>
48                 
49                 <term>haystack</term>
50                 
51                 <listitem>
52                     
53                     <para>文字列の行ベクトル.</para>
54                     
55                 </listitem>
56                 
57             </varlistentry>
58             
59             <varlistentry>
60                 
61                 <term>needle</term>
62                 
63                 <listitem>
64                     
65                     <para>文字列または文字列の行ベクトル.
66                         
67                         <varname>haystack</varname>の中で文字列を探します.
68                         
69                     </para>
70                     
71                 </listitem>
72                 
73             </varlistentry>
74             
75             <varlistentry>
76                 
77                 <term>row</term>
78                 
79                 <listitem>
80                     
81                     <para>インデックスのベクトル: 
82                         
83                         一致するものが見つかった行,
84                         
85                         または一致するものが見つからなかった場合は空の行列.
86                         
87                     </para>
88                     
89                 </listitem>
90                 
91             </varlistentry>
92             
93             <varlistentry>
94                 
95                 <term>which</term>
96                 
97                 <listitem>
98                     
99                     <para>インデックスのベクトル: 
100                         
101                         見つかったneedle文字列のインデックスまたは
102                         
103                         一致するものがなかった場合は空の行列.
104                         
105                     </para>
106                     
107                 </listitem>
108                 
109             </varlistentry>
110             
111             <varlistentry>
112                 
113                 <term>flag</term>
114                 
115                 <listitem>
116                     
117                     <para>
118                         文字 (正規表現の場合は<literal>"r"</literal>)
119                     </para>
120                     
121                 </listitem>
122                 
123             </varlistentry>
124             
125         </variablelist>
126         
127     </refsection>
128     
129     <refsection>
130         
131         <title>説明</title>
132         
133         <para>
134             
135             
136             
137             <varname>haystack</varname>の各エントリについて,
138             
139             <function>grep</function>は少なくとも
140             
141             <varname>needle</varname>の中の一つの文字列が
142             
143             部分文字列に一致するかどうかを探します.
144             
145             最低でも一致するものが一つある
146             
147             <varname>haystack</varname>のエントリのインデックスが
148             
149             出力引数<varname>row</varname>に返されます.
150             
151             オプションの出力引数<varname>which</varname>は,
152             
153             <varname>needle</varname>の最初に見つかった文字列のインデックスを
154             
155             指定します.
156             
157         </para>
158         
159         <para>
160             
161             3番目のパラメータに<varname>flag</varname><literal>="r"</literal>
162             
163             を指定した場合,
164             
165             <varname>needle</varname>に正規表現文字列を指定できます.
166             
167             この場合, <function>grep</function>は<varname>needle</varname>
168             
169             を正規表現として使用し,正規表現の規則に基づいて
170             
171             <varname>haystack</varname>とこの文字列を比較します.
172             
173             正規表現に関する詳細については関数<link linkend="regexp">regexp</link>
174             
175             を参照ください.
176             
177         </para>
178         
179     </refsection>
180     
181     <refsection>
182         
183         <title>例 #1</title>
184         
185         <para>
186             
187             以下の例では,<varname>txt</varname>変数に保存されている
188             
189             テキスト中で,1つまたは2つの文字列を探します.
190             
191         </para>
192         
193         <programlisting role="example"><![CDATA[ 
194 txt=['find matches of a string in a vector of strings'
195      'search position of a character string in an other string'
196      'Compare Strings'];
197 grep(txt,'strings')
198 grep(txt,['strings' 'Strings'])
199 [r,w]=grep(txt,['strings' 'Strings'])
200  ]]></programlisting>
201         
202     </refsection>
203     
204     <refsection>
205         
206         <title>例 #2</title>
207         
208         <para>以下の例では, 正規表現検索を行ないます.</para>
209         
210         <programlisting role="example"><![CDATA[ 
211 str = ["hat";"cat";"hhat";"chat";"hcat";"ccchat";"at";"dog"]
212 grep(str,'/[hc]+at/','r')
213 grep(str,'/[hc]?at/','r')
214 grep(str,'/cat|dog/','r')
215  ]]></programlisting>
216         
217     </refsection>
218     
219     <refsection role="see also">
220         
221         <title>参照</title>
222         
223         <simplelist type="inline">
224             
225             <member>
226                 
227                 <link linkend="strindex">strindex</link>
228                 
229             </member>
230             
231             <member>
232                 
233                 <link linkend="regexp">regexp</link>
234                 
235             </member>
236             
237         </simplelist>
238         
239     </refsection>
240     
241 </refentry>
242