annotate scripts/strings/substr.m @ 2355:c9f70d39255f

[project @ 1996-08-20 23:30:54 by jwe]
author jwe
date Tue, 20 Aug 1996 23:32:09 +0000
parents b5568c31ee2c
children 4f40efa995c1
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2313
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
1 ## Copyright (C) 1996 Kurt Hornik
2325
b5568c31ee2c [project @ 1996-07-15 22:20:21 by jwe]
jwe
parents: 2314
diff changeset
2 ##
2313
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
3 ## This file is part of Octave.
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
4 ##
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
5 ## Octave is free software; you can redistribute it and/or modify it
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
6 ## under the terms of the GNU General Public License as published by
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
7 ## the Free Software Foundation; either version 2, or (at your option)
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
8 ## any later version.
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
9 ##
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
10 ## Octave is distributed in the hope that it will be useful, but
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
11 ## WITHOUT ANY WARRANTY; without even the implied warranty of
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
13 ## General Public License for more details.
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
14 ##
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
15 ## You should have received a copy of the GNU General Public License
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
16 ## along with Octave; see the file COPYING. If not, write to the Free
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
17 ## Software Foundation, 59 Temple Place - Suite 330, Boston, MA
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
18 ## 02111-1307, USA.
2270
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
19
2355
c9f70d39255f [project @ 1996-08-20 23:30:54 by jwe]
jwe
parents: 2325
diff changeset
20 ## usage: substr (s, offset, len)
2311
2b5788792cad [project @ 1996-07-11 20:18:38 by jwe]
jwe
parents: 2303
diff changeset
21 ##
2355
c9f70d39255f [project @ 1996-08-20 23:30:54 by jwe]
jwe
parents: 2325
diff changeset
22 ## Returns the substring of S of length LEN starting at index OFFSET.
c9f70d39255f [project @ 1996-08-20 23:30:54 by jwe]
jwe
parents: 2325
diff changeset
23 ## If OFFSET is negative, extraction starts that far from the end of
c9f70d39255f [project @ 1996-08-20 23:30:54 by jwe]
jwe
parents: 2325
diff changeset
24 ## the string. If LEN is omitted, the substring extends to the end
c9f70d39255f [project @ 1996-08-20 23:30:54 by jwe]
jwe
parents: 2325
diff changeset
25 ## of S.
2270
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
26
2355
c9f70d39255f [project @ 1996-08-20 23:30:54 by jwe]
jwe
parents: 2325
diff changeset
27 ## Author: Kurt Hornik <Kurt.Hornik@ci.tuwien.ac.at>
c9f70d39255f [project @ 1996-08-20 23:30:54 by jwe]
jwe
parents: 2325
diff changeset
28 ## Adapted-By: jwe
2314
949ab8eba8bc [project @ 1996-07-12 03:58:02 by jwe]
jwe
parents: 2313
diff changeset
29
2355
c9f70d39255f [project @ 1996-08-20 23:30:54 by jwe]
jwe
parents: 2325
diff changeset
30 function t = substr (s, offset, len)
2270
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
31
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
32 if (nargin < 2 || nargin > 3)
2355
c9f70d39255f [project @ 1996-08-20 23:30:54 by jwe]
jwe
parents: 2325
diff changeset
33 usage ("substr (s, offset [, len])");
2270
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
34 endif
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
35
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
36 if (isstr (s))
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
37 nc = columns (s);
2355
c9f70d39255f [project @ 1996-08-20 23:30:54 by jwe]
jwe
parents: 2325
diff changeset
38 if (abs (offset) > 0 && abs (offset) <= nc)
c9f70d39255f [project @ 1996-08-20 23:30:54 by jwe]
jwe
parents: 2325
diff changeset
39 if (offset > 0)
c9f70d39255f [project @ 1996-08-20 23:30:54 by jwe]
jwe
parents: 2325
diff changeset
40 beg = offset;
c9f70d39255f [project @ 1996-08-20 23:30:54 by jwe]
jwe
parents: 2325
diff changeset
41 else
c9f70d39255f [project @ 1996-08-20 23:30:54 by jwe]
jwe
parents: 2325
diff changeset
42 beg = nc + offset + 1;
c9f70d39255f [project @ 1996-08-20 23:30:54 by jwe]
jwe
parents: 2325
diff changeset
43 endif
2270
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
44 if (nargin == 2)
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
45 eos = nc;
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
46 else
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
47 eos = beg + len - 1;
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
48 endif
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
49 if (eos <= nc)
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
50 t = s (:, beg:eos);
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
51 else
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
52 error ("substr: length = %d out of range", len);
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
53 endif
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
54 else
2355
c9f70d39255f [project @ 1996-08-20 23:30:54 by jwe]
jwe
parents: 2325
diff changeset
55 error ("substr: offset = %d out of range", offset);
2270
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
56 endif
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
57 else
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
58 error ("substr: expecting string argument");
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
59 endif
2325
b5568c31ee2c [project @ 1996-07-15 22:20:21 by jwe]
jwe
parents: 2314
diff changeset
60
2270
cfcf8ff7d2dd [project @ 1996-05-24 02:10:11 by jwe]
jwe
parents:
diff changeset
61 endfunction