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