|
3294
|
1 @c Copyright (C) 1996, 1997 John W. Eaton |
|
|
2 @c This is part of the Octave manual. |
|
|
3 @c For copying conditions, see the file gpl.texi. |
|
|
4 |
|
4167
|
5 @node Strings |
|
3294
|
6 @chapter Strings |
|
|
7 @cindex strings |
|
|
8 @cindex character strings |
|
|
9 @opindex " |
|
|
10 @opindex ' |
|
|
11 |
|
|
12 A @dfn{string constant} consists of a sequence of characters enclosed in |
|
|
13 either double-quote or single-quote marks. For example, both of the |
|
|
14 following expressions |
|
|
15 |
|
|
16 @example |
|
|
17 @group |
|
|
18 "parrot" |
|
|
19 'parrot' |
|
|
20 @end group |
|
|
21 @end example |
|
|
22 |
|
|
23 @noindent |
|
|
24 represent the string whose contents are @samp{parrot}. Strings in |
|
|
25 Octave can be of any length. |
|
|
26 |
|
|
27 Since the single-quote mark is also used for the transpose operator |
|
|
28 (@pxref{Arithmetic Ops}) but double-quote marks have no other purpose in |
|
|
29 Octave, it is best to use double-quote marks to denote strings. |
|
|
30 |
|
6554
|
31 @cindex escape sequence notation |
|
|
32 In double-quoted strings, the backslash character is used to introduce |
|
6623
|
33 @dfn{escape sequences} that represent other characters. For example, |
|
6554
|
34 @samp{\n} embeds a newline character in a double-quoted string and |
|
|
35 @samp{\"} embeds a double quote character. |
|
3294
|
36 |
|
6554
|
37 In single-quoted strings, backslash is not a special character. |
|
|
38 |
|
|
39 Here is an example showing the difference |
|
3294
|
40 |
|
6554
|
41 @example |
|
6556
|
42 @group |
|
6554
|
43 toascii ("\n") |
|
6570
|
44 @result{} 10 |
|
6554
|
45 toascii ('\n') |
|
6570
|
46 @result{} [ 92 110 ] |
|
6556
|
47 @end group |
|
6554
|
48 @end example |
|
3294
|
49 |
|
6554
|
50 You may also insert a single quote character in a single-quoted string |
|
|
51 by using two single quote characters in succession. For example, |
|
|
52 |
|
|
53 @example |
|
|
54 'I can''t escape' |
|
6570
|
55 @result{} I can't escape |
|
6554
|
56 @end example |
|
3294
|
57 |
|
|
58 Here is a table of all the escape sequences used in Octave. They are |
|
|
59 the same as those used in the C programming language. |
|
|
60 |
|
|
61 @table @code |
|
|
62 @item \\ |
|
|
63 Represents a literal backslash, @samp{\}. |
|
|
64 |
|
|
65 @item \" |
|
|
66 Represents a literal double-quote character, @samp{"}. |
|
|
67 |
|
|
68 @item \' |
|
|
69 Represents a literal single-quote character, @samp{'}. |
|
|
70 |
|
3893
|
71 @item \0 |
|
4946
|
72 Represents the ``nul'' character, control-@@, ASCII code 0. |
|
3893
|
73 |
|
3294
|
74 @item \a |
|
|
75 Represents the ``alert'' character, control-g, ASCII code 7. |
|
|
76 |
|
|
77 @item \b |
|
|
78 Represents a backspace, control-h, ASCII code 8. |
|
|
79 |
|
|
80 @item \f |
|
|
81 Represents a formfeed, control-l, ASCII code 12. |
|
|
82 |
|
|
83 @item \n |
|
|
84 Represents a newline, control-j, ASCII code 10. |
|
|
85 |
|
|
86 @item \r |
|
|
87 Represents a carriage return, control-m, ASCII code 13. |
|
|
88 |
|
|
89 @item \t |
|
|
90 Represents a horizontal tab, control-i, ASCII code 9. |
|
|
91 |
|
|
92 @item \v |
|
|
93 Represents a vertical tab, control-k, ASCII code 11. |
|
|
94 |
|
|
95 @c We don't do octal or hex this way yet. |
|
|
96 @c |
|
|
97 @c @item \@var{nnn} |
|
|
98 @c Represents the octal value @var{nnn}, where @var{nnn} are one to three |
|
|
99 @c digits between 0 and 7. For example, the code for the ASCII ESC |
|
|
100 @c (escape) character is @samp{\033}.@refill |
|
|
101 @c |
|
|
102 @c @item \x@var{hh}@dots{} |
|
|
103 @c Represents the hexadecimal value @var{hh}, where @var{hh} are hexadecimal |
|
|
104 @c digits (@samp{0} through @samp{9} and either @samp{A} through @samp{F} or |
|
|
105 @c @samp{a} through @samp{f}). Like the same construct in @sc{ansi} C, |
|
|
106 @c the escape |
|
|
107 @c sequence continues until the first non-hexadecimal digit is seen. However, |
|
|
108 @c using more than two hexadecimal digits produces undefined results. (The |
|
|
109 @c @samp{\x} escape sequence is not allowed in @sc{posix} @code{awk}.)@refill |
|
|
110 @end table |
|
|
111 |
|
|
112 Strings may be concatenated using the notation for defining matrices. |
|
|
113 For example, the expression |
|
|
114 |
|
|
115 @example |
|
|
116 [ "foo" , "bar" , "baz" ] |
|
|
117 @end example |
|
|
118 |
|
|
119 @noindent |
|
|
120 produces the string whose contents are @samp{foobarbaz}. @xref{Numeric |
|
3402
|
121 Data Types}, for more information about creating matrices. |
|
3294
|
122 |
|
|
123 @menu |
|
|
124 * Creating Strings:: |
|
|
125 * Searching and Replacing:: |
|
|
126 * String Conversions:: |
|
|
127 * Character Class Functions:: |
|
|
128 @end menu |
|
|
129 |
|
4167
|
130 @node Creating Strings |
|
3294
|
131 @section Creating Strings |
|
|
132 |
|
6623
|
133 The easiest way to create a string is, as illustrated in the introduction, |
|
|
134 to enclose a text in double-quotes or single-quotes. It is however |
|
|
135 possible to create a string without actually writing a text. The |
|
|
136 function @code{blanks} creates a string of a given length consisting |
|
|
137 only of blank characters (ASCII code 32). |
|
|
138 |
|
3361
|
139 @DOCSTRING(blanks) |
|
3294
|
140 |
|
6623
|
141 The string representation used by Octave is an array of characters, so |
|
|
142 the result of @code{blanks(10)} is actually a row vector of length 10 |
|
|
143 containing the value 32 in all places. This lends itself to the obvious |
|
|
144 generalisation to character matrices. Using a matrix of characters, it |
|
|
145 is possible to represent a collection of same-length strings in one |
|
|
146 variable. The convention used in Octave is that each row in a |
|
|
147 character matrix is a separate string, but letting each column represent |
|
|
148 a string is equally possible. |
|
|
149 |
|
|
150 The easiest way to create a character matrix is to put several strings |
|
|
151 together into a matrix. |
|
|
152 |
|
|
153 @example |
|
|
154 collection = [ "String #1"; "String #2" ]; |
|
|
155 @end example |
|
|
156 |
|
|
157 @noindent |
|
|
158 This creates a 2-by-9 character matrix. |
|
|
159 |
|
|
160 One relevant question is, what happens when character matrix is |
|
|
161 created from strings of different length. The answer is that Octave |
|
|
162 puts blank characters at the end of strings shorter than the longest |
|
|
163 string. While it is possible to use a different character than the |
|
|
164 blank character using the @code{string_fill_char} function, it shows |
|
|
165 a problem with character matrices. It simply isn't possible to |
|
|
166 represent strings of different lengths. The solution is to use a cell |
|
|
167 array of strings, which is described in @ref{Cell Arrays of Strings}. |
|
|
168 |
|
4358
|
169 @DOCSTRING(char) |
|
|
170 |
|
3361
|
171 @DOCSTRING(strcat) |
|
3294
|
172 |
|
6502
|
173 @DOCSTRING(strvcat) |
|
|
174 |
|
|
175 @DOCSTRING(strtrunc) |
|
|
176 |
|
3361
|
177 @DOCSTRING(string_fill_char) |
|
3294
|
178 |
|
3361
|
179 @DOCSTRING(str2mat) |
|
3294
|
180 |
|
4535
|
181 @DOCSTRING(ischar) |
|
|
182 |
|
6502
|
183 @DOCSTRING(mat2str) |
|
|
184 |
|
|
185 @DOCSTRING(num2str) |
|
3294
|
186 |
|
6623
|
187 @DOCSTRING(int2str) |
|
|
188 |
|
|
189 @node Comparing Strings |
|
|
190 @section Comparing Strings |
|
|
191 |
|
|
192 Since a string is a character array comparison between strings work |
|
|
193 element by element as the following example shows. |
|
|
194 |
|
|
195 @example |
|
|
196 GNU = "GNU's Not UNIX"; |
|
|
197 spaces = (GNU == " ") |
|
|
198 @result{} spaces = |
|
|
199 0 0 0 0 0 1 0 0 0 1 0 0 0 0 |
|
|
200 @end example |
|
|
201 |
|
|
202 @noindent |
|
|
203 To determine if two functions are identical it is therefore necessary |
|
|
204 to use the @code{strcmp} or @code{strncpm} functions. Similar |
|
|
205 functions exists for doing case-insensitive comparisons. |
|
|
206 |
|
|
207 @DOCSTRING(strcmp) |
|
|
208 |
|
|
209 @DOCSTRING(strcmpi) |
|
|
210 |
|
|
211 @DOCSTRING(strncmp) |
|
|
212 |
|
|
213 @DOCSTRING(strncmpi) |
|
|
214 |
|
|
215 @node Manipulating Strings |
|
|
216 @section Manipulating Strings |
|
|
217 |
|
|
218 Octave supports a wide range of functions for manipulating strings. |
|
|
219 Since a string is just a matrix, simple manipulations can be accomplished |
|
|
220 using standard operators. The following example shows how to replace |
|
|
221 all blank characters with underscores. |
|
|
222 |
|
|
223 @example |
|
|
224 quote = "First things first, but not necessarily in that order"; |
|
|
225 quote( quote == " " ) = "_" |
|
|
226 @print{} quote = First_things_first,_but_not_necessarily_in_that_order |
|
|
227 @end example |
|
|
228 |
|
|
229 For more complex manipulations, such as searching, replacing, and |
|
|
230 general regular expressions, the following function come with Octave. |
|
3294
|
231 |
|
3361
|
232 @DOCSTRING(deblank) |
|
3294
|
233 |
|
3361
|
234 @DOCSTRING(findstr) |
|
3294
|
235 |
|
3361
|
236 @DOCSTRING(index) |
|
3294
|
237 |
|
3361
|
238 @DOCSTRING(rindex) |
|
3294
|
239 |
|
6502
|
240 @DOCSTRING(strfind) |
|
|
241 |
|
|
242 @DOCSTRING(strmatch) |
|
|
243 |
|
|
244 @DOCSTRING(strtok) |
|
|
245 |
|
3361
|
246 @DOCSTRING(split) |
|
3294
|
247 |
|
3361
|
248 @DOCSTRING(strrep) |
|
3294
|
249 |
|
3361
|
250 @DOCSTRING(substr) |
|
3294
|
251 |
|
5582
|
252 @DOCSTRING(regexp) |
|
|
253 |
|
|
254 @DOCSTRING(regexpi) |
|
|
255 |
|
6549
|
256 @DOCSTRING(regexprep) |
|
|
257 |
|
4167
|
258 @node String Conversions |
|
3294
|
259 @section String Conversions |
|
|
260 |
|
6623
|
261 Octave supports various kinds of conversions between strings and |
|
|
262 numbers. As an example, it is possible to convert a string containing |
|
|
263 a hexadecimal number to a floating point number. |
|
|
264 |
|
|
265 @example |
|
|
266 hex2dec ("FF") |
|
|
267 @result{} ans = 255 |
|
|
268 @end example |
|
|
269 |
|
3361
|
270 @DOCSTRING(bin2dec) |
|
3294
|
271 |
|
3361
|
272 @DOCSTRING(dec2bin) |
|
3294
|
273 |
|
3361
|
274 @DOCSTRING(dec2hex) |
|
3294
|
275 |
|
3361
|
276 @DOCSTRING(hex2dec) |
|
3294
|
277 |
|
3920
|
278 @DOCSTRING(dec2base) |
|
|
279 |
|
|
280 @DOCSTRING(base2dec) |
|
|
281 |
|
6623
|
282 @DOCSTRING(str2double) |
|
3920
|
283 |
|
6623
|
284 @DOCSTRING(strjust) |
|
6502
|
285 |
|
3361
|
286 @DOCSTRING(str2num) |
|
3294
|
287 |
|
3361
|
288 @DOCSTRING(toascii) |
|
3294
|
289 |
|
3361
|
290 @DOCSTRING(tolower) |
|
3294
|
291 |
|
3361
|
292 @DOCSTRING(toupper) |
|
3294
|
293 |
|
3428
|
294 @DOCSTRING(do_string_escapes) |
|
|
295 |
|
3361
|
296 @DOCSTRING(undo_string_escapes) |
|
3294
|
297 |
|
4167
|
298 @node Character Class Functions |
|
3294
|
299 @section Character Class Functions |
|
|
300 |
|
|
301 Octave also provides the following character class test functions |
|
|
302 patterned after the functions in the standard C library. They all |
|
|
303 operate on string arrays and return matrices of zeros and ones. |
|
|
304 Elements that are nonzero indicate that the condition was true for the |
|
|
305 corresponding character in the string array. For example, |
|
|
306 |
|
|
307 @example |
|
|
308 @group |
|
|
309 isalpha ("!Q@@WERT^Y&") |
|
|
310 @result{} [ 0, 1, 0, 1, 1, 1, 1, 0, 1, 0 ] |
|
|
311 @end group |
|
|
312 @end example |
|
|
313 |
|
3361
|
314 @DOCSTRING(isalnum) |
|
3294
|
315 |
|
3361
|
316 @DOCSTRING(isalpha) |
|
|
317 |
|
|
318 @DOCSTRING(isascii) |
|
3294
|
319 |
|
3361
|
320 @DOCSTRING(iscntrl) |
|
3294
|
321 |
|
3361
|
322 @DOCSTRING(isdigit) |
|
3294
|
323 |
|
3361
|
324 @DOCSTRING(isgraph) |
|
3294
|
325 |
|
6549
|
326 @DOCSTRING(isletter) |
|
|
327 |
|
3361
|
328 @DOCSTRING(islower) |
|
3294
|
329 |
|
3361
|
330 @DOCSTRING(isprint) |
|
3294
|
331 |
|
3361
|
332 @DOCSTRING(ispunct) |
|
3294
|
333 |
|
3361
|
334 @DOCSTRING(isspace) |
|
3294
|
335 |
|
3361
|
336 @DOCSTRING(isupper) |
|
3294
|
337 |
|
3361
|
338 @DOCSTRING(isxdigit) |
