annotate src/ov-list.cc @ 3538:0ff7323dab8b

[project @ 2000-02-02 12:36:25 by jwe]
author jwe
date Wed, 02 Feb 2000 12:36:37 +0000
parents b80bbb43a1a9
children f9ea3dcf58ee
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
1 /*
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
2
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
3 Copyright (C) 1996, 1997 John W. Eaton
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
4
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
5 This file is part of Octave.
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
6
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
7 Octave is free software; you can redistribute it and/or modify it
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
8 under the terms of the GNU General Public License as published by the
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
9 Free Software Foundation; either version 2, or (at your option) any
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
10 later version.
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
11
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
12 Octave is distributed in the hope that it will be useful, but WITHOUT
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
13 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
15 for more details.
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
16
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
17 You should have received a copy of the GNU General Public License
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
18 along with Octave; see the file COPYING. If not, write to the Free
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
19 Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
20
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
21 */
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
22
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
23 #if defined (__GNUG__)
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
24 #pragma implementation
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
25 #endif
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
26
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
27 #ifdef HAVE_CONFIG_H
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
28 #include <config.h>
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
29 #endif
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
30
3503
d14c483b3c12 [project @ 2000-02-01 04:06:07 by jwe]
jwe
parents: 3448
diff changeset
31 #include <iostream>
d14c483b3c12 [project @ 2000-02-01 04:06:07 by jwe]
jwe
parents: 3448
diff changeset
32 #include <strstream>
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
33
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
34 #include "lo-utils.h"
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
35
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
36 #include "defun.h"
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
37 #include "error.h"
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
38 #include "ov-list.h"
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
39 #include "unwind-prot.h"
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
40
3219
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
41 DEFINE_OCTAVE_ALLOCATOR (octave_list);
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
42
3219
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
43 DEFINE_OV_TYPEID_FUNCTIONS_AND_DATA (octave_list, "list");
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
44
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
45 octave_value
2974
ebbc34ff7f66 [project @ 1997-05-15 19:36:16 by jwe]
jwe
parents: 2962
diff changeset
46 octave_list::do_index_op (const octave_value_list& idx)
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
47 {
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
48 octave_value retval;
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
49
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
50 if (idx.length () == 1)
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
51 {
3219
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
52 idx_vector i = idx (0).index_vector ();
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
53
3219
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
54 retval = octave_value_list (lst.index (i));
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
55 }
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
56 else
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
57 error ("lists may only be indexed by a single scalar");
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
58
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
59 return retval;
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
60 }
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
61
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
62 void
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
63 octave_list::assign (const octave_value_list& idx, const octave_value& rhs)
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
64 {
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
65 if (idx.length () == 1)
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
66 {
3202
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
67 int i = idx(0).int_value (true);
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
68
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
69 if (! error_state)
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
70 {
3202
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
71 int n = lst.length ();
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
72
3202
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
73 if (i > 0 && (Vresize_on_range_error || i <= n))
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
74 lst(i-1) = rhs;
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
75 else
3202
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
76 error ("list index = %d out of range", i);
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
77 }
3202
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
78 else
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
79 error ("list index must be an integer");
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
80 }
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
81 else
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
82 error ("lists may only be indexed by a single scalar");
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
83 }
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
84
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
85 void
3523
b80bbb43a1a9 [project @ 2000-02-02 10:25:52 by jwe]
jwe
parents: 3503
diff changeset
86 octave_list::print (std::ostream& os, bool) const
2901
e6d25bc478dd [project @ 1997-04-30 03:41:26 by jwe]
jwe
parents: 2882
diff changeset
87 {
e6d25bc478dd [project @ 1997-04-30 03:41:26 by jwe]
jwe
parents: 2882
diff changeset
88 print_raw (os);
e6d25bc478dd [project @ 1997-04-30 03:41:26 by jwe]
jwe
parents: 2882
diff changeset
89 }
e6d25bc478dd [project @ 1997-04-30 03:41:26 by jwe]
jwe
parents: 2882
diff changeset
90
e6d25bc478dd [project @ 1997-04-30 03:41:26 by jwe]
jwe
parents: 2882
diff changeset
91 void
3523
b80bbb43a1a9 [project @ 2000-02-02 10:25:52 by jwe]
jwe
parents: 3503
diff changeset
92 octave_list::print_raw (std::ostream& os, bool) const
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
93 {
2985
aa9d0c0e0458 [project @ 1997-05-16 06:54:18 by jwe]
jwe
parents: 2974
diff changeset
94 unwind_protect::begin_frame ("octave_list_print");
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
95
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
96 int n = lst.length ();
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
97
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
98 if (n > 0)
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
99 {
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
100 indent (os);
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
101 os << "(";
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
102 newline (os);
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
103
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
104 increment_indent_level ();
2916
4e7bea116f24 [project @ 1997-04-30 20:56:31 by jwe]
jwe
parents: 2905
diff changeset
105
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
106 for (int i = 0; i < n; i++)
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
107 {
3523
b80bbb43a1a9 [project @ 2000-02-02 10:25:52 by jwe]
jwe
parents: 3503
diff changeset
108 std::ostrstream buf;
3538
0ff7323dab8b [project @ 2000-02-02 12:36:25 by jwe]
jwe
parents: 3523
diff changeset
109 buf << "[" << i+1 << "]" << std::ends;
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
110 const char *nm = buf.str ();
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
111
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
112 octave_value val = lst(i);
2916
4e7bea116f24 [project @ 1997-04-30 20:56:31 by jwe]
jwe
parents: 2905
diff changeset
113
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
114 val.print_with_name (os, nm);
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
115
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
116 delete [] nm;
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
117 }
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
118
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
119 decrement_indent_level ();
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
120
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
121 indent (os);
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
122 os << ")";
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
123 }
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
124 else
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
125 os << "()";
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
126
2901
e6d25bc478dd [project @ 1997-04-30 03:41:26 by jwe]
jwe
parents: 2882
diff changeset
127 newline (os);
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
128
2985
aa9d0c0e0458 [project @ 1997-05-16 06:54:18 by jwe]
jwe
parents: 2974
diff changeset
129 unwind_protect::run_frame ("octave_list_print");
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
130 }
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
131
2901
e6d25bc478dd [project @ 1997-04-30 03:41:26 by jwe]
jwe
parents: 2882
diff changeset
132 bool
3523
b80bbb43a1a9 [project @ 2000-02-02 10:25:52 by jwe]
jwe
parents: 3503
diff changeset
133 octave_list::print_name_tag (std::ostream& os, const std::string& name) const
2901
e6d25bc478dd [project @ 1997-04-30 03:41:26 by jwe]
jwe
parents: 2882
diff changeset
134 {
e6d25bc478dd [project @ 1997-04-30 03:41:26 by jwe]
jwe
parents: 2882
diff changeset
135 indent (os);
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
136 if (lst.length () == 0)
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
137 os << name << " = ";
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
138 else
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
139 {
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
140 os << name << " =";
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
141 newline (os);
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
142 }
2901
e6d25bc478dd [project @ 1997-04-30 03:41:26 by jwe]
jwe
parents: 2882
diff changeset
143 return false;
e6d25bc478dd [project @ 1997-04-30 03:41:26 by jwe]
jwe
parents: 2882
diff changeset
144 }
e6d25bc478dd [project @ 1997-04-30 03:41:26 by jwe]
jwe
parents: 2882
diff changeset
145
2993
91589ab98e37 [project @ 1997-05-21 21:44:54 by jwe]
jwe
parents: 2985
diff changeset
146 DEFUN (list, args, ,
3447
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
147 "-*- texinfo -*-\n\
3448
0fb75d95b14f [project @ 2000-01-17 20:38:31 by jwe]
jwe
parents: 3447
diff changeset
148 @deftypefn {Built-in Function} {} list (@var{a1}, @var{a2}, @dots{})\n\
3447
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
149 Create a new list with elements given by the arguments @var{a1},\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
150 @var{a2}, @dots{}.\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
151 @end deftypefn")
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
152 {
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
153 return octave_value (args);
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
154 }
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
155
3219
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
156 DEFUN (nth, args, ,
3447
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
157 "-*- texinfo -*-\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
158 @deftypefn {Built-in Function} {} nth (@var{list}, @var{n})\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
159 Return the @var{n}-th element of @var{list}.\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
160 @end deftypefn")
3219
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
161 {
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
162 octave_value retval;
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
163
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
164 if (args.length () == 2)
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
165 {
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
166 octave_value_list lst = args(0).list_value ();
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
167
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
168 if (! error_state)
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
169 {
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
170 int n = args(1).int_value (true);
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
171
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
172 if (! error_state)
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
173 {
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
174 if (n > 0 && n <= lst.length ())
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
175 retval = lst(n-1);
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
176 else
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
177 error ("nth: index = %d out of range", n);
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
178 }
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
179 else
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
180 error ("nth: second argument must be an integer");
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
181 }
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
182 else
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
183 error ("nth: first argument must be a list");
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
184 }
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
185 else
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
186 print_usage ("nth");
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
187
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
188 return retval;
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
189 }
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
190
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
191 DEFUN (append, args, ,
3447
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
192 "-*- texinfo -*-\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
193 @deftypefn {Built-in Function} {} append (@var{list}, @var{a1}, @var{a2}, @dots{})\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
194 Return a new list created by appending @var{a1}, @var{a1}, @dots{}, to\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
195 @var{list}. If any of the arguments to be appended is a list, its\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
196 elements are appended individually. For example,\n\
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
197 \n\
3447
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
198 @example\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
199 x = list (1, 2);\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
200 y = list (3, 4);\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
201 append (x, y);\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
202 @end example\n\
3219
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
203 \n\
3447
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
204 @noindent\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
205 results in the list containing the four elements @samp{(1 2 3 4)}, not\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
206 a list containing the three elements @samp{(1 2 (3 4))}.\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
207 @end deftypefn")
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
208 {
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
209 octave_value retval;
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
210
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
211 int nargin = args.length ();
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
212
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
213 if (nargin > 1)
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
214 {
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
215 octave_value_list tmp = args(0).list_value ();
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
216
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
217 if (! error_state)
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
218 {
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
219 for (int i = 1; i < nargin; i++)
3219
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
220 {
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
221 octave_value ov = args(i);
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
222
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
223 if (ov.is_list ())
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
224 tmp.append (ov.list_value ());
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
225 else
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
226 tmp.append (ov);
30770ba4457a [project @ 1998-11-13 03:44:31 by jwe]
jwe
parents: 3204
diff changeset
227 }
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
228
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
229 retval = tmp;
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
230 }
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
231 }
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
232 else
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
233 print_usage ("append");
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
234
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
235 return retval;
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
236 }
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
237
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
238 DEFUN (reverse, args, ,
3447
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
239 "-*- texinfo -*-\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
240 @deftypefn {Built-in Function} {} reverse (@var{list})\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
241 Return a new list created by reversing the elements of @var{list}.\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
242 @end deftypefn")
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
243 {
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
244 octave_value retval;
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
245
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
246 int nargin = args.length ();
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
247
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
248 if (nargin == 1)
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
249 {
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
250 octave_value_list tmp = args(0).list_value ();
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
251
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
252 if (! error_state)
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
253 retval = tmp.reverse ();
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
254 }
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
255 else
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
256 print_usage ("reverse");
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
257
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
258 return retval;
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
259 }
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
260
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
261 DEFUN (splice, args, ,
3447
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
262 "-*- texinfo -*-\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
263 @deftypefn {Built-in Function} {} splice (@var{list_1}, @var{offset}, @var{length}, @var{list_2})\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
264 Replace @var{length} elements of @var{list_1} beginning at\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
265 @var{offset} with the contents of @var{list_2} (if any). If\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
266 @var{length} is omitted, all elements from @var{offset} to the end of\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
267 @var{list_1} are replaced. As a special case, if @var{offset} is one\n\
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
268 greater than the length of @var{list_1} and @var{length} is 0, splice\n\
3448
0fb75d95b14f [project @ 2000-01-17 20:38:31 by jwe]
jwe
parents: 3447
diff changeset
269 is equivalent to @code{append (@var{list_1}, @var{list_2})}.\n\
3447
5c76d8f267f7 [project @ 2000-01-17 20:12:43 by jwe]
jwe
parents: 3219
diff changeset
270 @end deftypefn")
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
271 {
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
272 octave_value retval;
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
273
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
274 int nargin = args.length ();
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
275
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
276 if (nargin > 1 && nargin < 5)
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
277 {
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
278 octave_value_list list_1 = args(0).list_value ();
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
279
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
280 if (! error_state)
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
281 {
3202
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
282 int offset = args(1).int_value (true);
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
283
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
284 if (! error_state)
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
285 {
3202
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
286 offset--;
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
287
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
288 int length = 0;
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
289
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
290 octave_value_list list_2;
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
291
3202
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
292 if (nargin < 3)
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
293 length = list_1.length () - offset;
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
294 else
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
295 {
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
296 length = args(2).int_value (true);
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
297
3202
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
298 if (! error_state)
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
299 {
3202
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
300 if (nargin == 4)
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
301 {
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
302 list_2 = args(3).list_value ();
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
303
3202
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
304 if (error_state)
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
305 error ("splice: fourth argument must be a list");
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
306 }
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
307 }
3202
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
308 else
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
309 error ("splice: LENGTH must be an integer");
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
310 }
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
311
3202
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
312 if (! error_state)
44d82b369c78 [project @ 1998-10-29 20:27:57 by jwe]
jwe
parents: 3196
diff changeset
313 retval = list_1.splice (offset, length, list_2);
3196
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
314 }
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
315 else
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
316 error ("splice: OFFSET must be an integer");
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
317 }
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
318 else
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
319 error ("splice: first argument must be a list");
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
320 }
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
321 else
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
322 print_usage ("splice");
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
323
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
324 return retval;
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
325 }
3ac3e8edc258 [project @ 1998-10-28 23:04:39 by jwe]
jwe
parents: 3014
diff changeset
326
2882
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
327 /*
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
328 ;;; Local Variables: ***
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
329 ;;; mode: C++ ***
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
330 ;;; End: ***
05926e1b367d [project @ 1997-04-24 09:48:59 by jwe]
jwe
parents:
diff changeset
331 */