|
2376
|
1 /* |
|
|
2 |
|
|
3 Copyright (C) 1996 John W. Eaton |
|
|
4 |
|
|
5 This file is part of Octave. |
|
|
6 |
|
|
7 Octave is free software; you can redistribute it and/or modify it |
|
|
8 under the terms of the GNU General Public License as published by the |
|
|
9 Free Software Foundation; either version 2, or (at your option) any |
|
|
10 later version. |
|
|
11 |
|
|
12 Octave is distributed in the hope that it will be useful, but WITHOUT |
|
|
13 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
|
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
|
15 for more details. |
|
|
16 |
|
|
17 You should have received a copy of the GNU General Public License |
|
|
18 along with Octave; see the file COPYING. If not, write to the Free |
|
|
19 Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. |
|
|
20 |
|
|
21 */ |
|
|
22 |
|
|
23 #if !defined (octave_value_h) |
|
|
24 #define octave_value_h 1 |
|
|
25 |
|
|
26 #if defined (__GNUG__) |
|
|
27 #pragma interface |
|
|
28 #endif |
|
|
29 |
|
|
30 #include <cstdlib> |
|
|
31 |
|
|
32 #include <string> |
|
|
33 |
|
|
34 class ostream; |
|
|
35 |
|
|
36 #include <SLList.h> |
|
|
37 |
|
|
38 #include "Range.h" |
|
|
39 #include "idx-vector.h" |
|
|
40 #include "mx-base.h" |
|
|
41 #include "str-vec.h" |
|
|
42 |
|
|
43 #include "error.h" |
|
|
44 #include "pt-exp.h" |
|
|
45 |
|
|
46 class Octave_map; |
|
|
47 class octave_value_list; |
|
|
48 |
|
|
49 // Constants. |
|
|
50 |
|
|
51 // This just provides a way to avoid infinite recursion when building |
|
|
52 // octave_value objects. |
|
|
53 |
|
|
54 class |
|
|
55 octave_xvalue |
|
|
56 { |
|
|
57 public: |
|
|
58 |
|
|
59 octave_xvalue (void) { } |
|
|
60 }; |
|
|
61 |
|
|
62 class |
|
|
63 octave_value |
|
|
64 { |
|
|
65 public: |
|
|
66 |
|
|
67 typedef octave_value (*binary_op_fcn) |
|
|
68 (const octave_value&, const octave_value&); |
|
|
69 |
|
|
70 typedef octave_value (*assign_op_fcn) |
|
|
71 (octave_value&, const octave_value_list&, const octave_value&); |
|
|
72 |
|
2409
|
73 typedef octave_value * (*type_conv_fcn) (const octave_value&); |
|
2376
|
74 |
|
|
75 enum binary_op |
|
|
76 { |
|
|
77 add, |
|
|
78 sub, |
|
|
79 mul, |
|
|
80 div, |
|
|
81 pow, |
|
|
82 ldiv, |
|
|
83 lt, |
|
|
84 le, |
|
|
85 eq, |
|
|
86 ge, |
|
|
87 gt, |
|
|
88 ne, |
|
|
89 el_mul, |
|
|
90 el_div, |
|
|
91 el_pow, |
|
|
92 el_ldiv, |
|
|
93 el_and, |
|
|
94 el_or, |
|
|
95 struct_ref, |
|
|
96 num_binary_ops, |
|
|
97 unknown_binary_op |
|
|
98 }; |
|
|
99 |
|
|
100 static string binary_op_as_string (binary_op); |
|
|
101 |
|
|
102 enum magic_colon { magic_colon_t }; |
|
|
103 enum all_va_args { all_va_args_t }; |
|
|
104 |
|
|
105 octave_value (void); |
|
|
106 octave_value (double d); |
|
|
107 octave_value (const Matrix& m); |
|
|
108 octave_value (const DiagMatrix& d); |
|
|
109 octave_value (const RowVector& v, int pcv = -1); |
|
|
110 octave_value (const ColumnVector& v, int pcv = -1); |
|
|
111 octave_value (const Complex& C); |
|
|
112 octave_value (const ComplexMatrix& m); |
|
|
113 octave_value (const ComplexDiagMatrix& d); |
|
|
114 octave_value (const ComplexRowVector& v, int pcv = -1); |
|
|
115 octave_value (const ComplexColumnVector& v, int pcv = -1); |
|
|
116 octave_value (const char *s); |
|
|
117 octave_value (const string& s); |
|
|
118 octave_value (const string_vector& s); |
|
|
119 octave_value (const charMatrix& chm, bool is_string = false); |
|
|
120 octave_value (double base, double limit, double inc); |
|
|
121 octave_value (const Range& r); |
|
|
122 octave_value (const Octave_map& m); |
|
|
123 octave_value (octave_value::magic_colon); |
|
|
124 octave_value (octave_value::all_va_args); |
|
|
125 |
|
|
126 octave_value (octave_value *new_rep); |
|
|
127 |
|
|
128 // Copy constructor. |
|
|
129 |
|
|
130 octave_value (const octave_value& a) |
|
|
131 { |
|
|
132 rep = a.rep; |
|
|
133 rep->count++; |
|
|
134 } |
|
|
135 |
|
|
136 // Delete the representation of this constant if the count drops to |
|
|
137 // zero. |
|
|
138 |
|
|
139 virtual ~octave_value (void); |
|
|
140 |
|
|
141 // This should only be called for derived types. |
|
|
142 |
|
|
143 virtual octave_value *clone (void) { panic_impossible (); } |
|
|
144 |
|
|
145 void make_unique (void) |
|
|
146 { |
|
|
147 if (rep->count > 1) |
|
|
148 { |
|
|
149 --rep->count; |
|
|
150 rep = rep->clone (); |
|
|
151 rep->count = 1; |
|
|
152 } |
|
|
153 } |
|
|
154 |
|
|
155 #if 0 |
|
|
156 void *operator new (size_t size); |
|
|
157 void operator delete (void *p, size_t size); |
|
|
158 #endif |
|
|
159 |
|
|
160 // Simple assignment. |
|
|
161 |
|
|
162 octave_value& operator = (const octave_value& a) |
|
|
163 { |
|
|
164 if (rep != a.rep) |
|
|
165 { |
|
|
166 if (--rep->count == 0) |
|
|
167 delete rep; |
|
|
168 |
|
|
169 rep = a.rep; |
|
|
170 rep->count++; |
|
|
171 } |
|
|
172 |
|
|
173 return *this; |
|
|
174 } |
|
|
175 |
|
2409
|
176 virtual type_conv_fcn numeric_conversion_function (void) const |
|
2376
|
177 { return rep->numeric_conversion_function (); } |
|
|
178 |
|
2409
|
179 void maybe_mutate (void); |
|
|
180 |
|
|
181 virtual octave_value *try_narrow_conversion (void) |
|
|
182 { return rep->try_narrow_conversion (); } |
|
|
183 |
|
2376
|
184 virtual octave_value index (const octave_value_list& idx) const |
|
|
185 { return rep->index (idx); } |
|
|
186 |
|
2409
|
187 bool convert_and_assign (const octave_value_list& idx, |
|
|
188 const octave_value& rhs); |
|
|
189 |
|
|
190 bool try_assignment_with_conversion (const octave_value_list& idx, |
|
|
191 const octave_value& rhs); |
|
|
192 |
|
|
193 bool try_assignment (const octave_value_list& idx, |
|
|
194 const octave_value& rhs); |
|
|
195 |
|
2376
|
196 octave_value& assign (const octave_value_list& idx, const octave_value& rhs); |
|
|
197 |
|
|
198 virtual idx_vector index_vector (void) const |
|
|
199 { return rep->index_vector (); } |
|
|
200 |
|
|
201 virtual octave_value struct_elt_val (const string& nm) const |
|
|
202 { return rep->struct_elt_val (nm); } |
|
|
203 |
|
|
204 virtual octave_value& struct_elt_ref (const string& nm) |
|
|
205 { return rep->struct_elt_ref (nm); } |
|
|
206 |
|
|
207 #if 0 |
|
|
208 // Simple structure assignment. |
|
|
209 |
|
|
210 octave_value assign_map_element (SLList<string>& list, |
|
|
211 octave_value& rhs); |
|
|
212 |
|
|
213 // Indexed structure assignment. |
|
|
214 |
|
|
215 octave_value assign_map_element (SLList<string>& list, |
|
|
216 octave_value& rhs, |
|
|
217 const octave_value_list& args); |
|
|
218 #endif |
|
|
219 |
|
|
220 // Size. |
|
|
221 |
|
|
222 virtual int rows (void) const |
|
|
223 { return rep->rows (); } |
|
|
224 |
|
|
225 virtual int columns (void) const |
|
|
226 { return rep->columns (); } |
|
|
227 |
|
|
228 // Does this constant have a type? Both of these are provided since |
|
|
229 // it is sometimes more natural to write is_undefined() instead of |
|
|
230 // ! is_defined(). |
|
|
231 |
|
|
232 virtual bool is_defined (void) const |
|
|
233 { return rep->is_defined (); } |
|
|
234 |
|
|
235 bool is_undefined (void) const |
|
|
236 { return ! is_defined (); } |
|
|
237 |
|
|
238 virtual bool is_real_scalar (void) const |
|
|
239 { return rep->is_real_scalar (); } |
|
|
240 |
|
|
241 virtual bool is_real_matrix (void) const |
|
|
242 { return rep->is_real_matrix (); } |
|
|
243 |
|
|
244 virtual bool is_complex_scalar (void) const |
|
|
245 { return rep->is_complex_scalar (); } |
|
|
246 |
|
|
247 virtual bool is_complex_matrix (void) const |
|
|
248 { return rep->is_complex_matrix (); } |
|
|
249 |
|
|
250 virtual bool is_char_matrix (void) const |
|
|
251 { return rep->is_char_matrix (); } |
|
|
252 |
|
|
253 virtual bool is_string (void) const |
|
|
254 { return rep->is_string (); } |
|
|
255 |
|
|
256 virtual bool is_range (void) const |
|
|
257 { return rep->is_range (); } |
|
|
258 |
|
|
259 virtual bool is_map (void) const |
|
|
260 { return rep->is_map (); } |
|
|
261 |
|
|
262 virtual bool is_magic_colon (void) const |
|
|
263 { return rep->is_magic_colon (); } |
|
|
264 |
|
|
265 virtual bool is_all_va_args (void) const |
|
|
266 { return rep->is_all_va_args (); } |
|
|
267 |
|
|
268 // Are any or all of the elements in this constant nonzero? |
|
|
269 |
|
|
270 virtual octave_value all (void) const |
|
|
271 { return rep->all (); } |
|
|
272 |
|
|
273 virtual octave_value any (void) const |
|
|
274 { return rep->any (); } |
|
|
275 |
|
|
276 // Other type stuff. |
|
|
277 |
|
|
278 virtual bool is_real_type (void) const |
|
|
279 { return rep->is_real_type (); } |
|
|
280 |
|
|
281 virtual bool is_complex_type (void) const |
|
|
282 { return rep->is_complex_type (); } |
|
|
283 |
|
|
284 virtual bool is_scalar_type (void) const |
|
|
285 { return rep->is_scalar_type (); } |
|
|
286 |
|
|
287 virtual bool is_matrix_type (void) const |
|
|
288 { return rep->is_matrix_type (); } |
|
|
289 |
|
|
290 virtual bool is_numeric_type (void) const |
|
|
291 { return rep->is_numeric_type (); } |
|
|
292 |
|
|
293 virtual bool valid_as_scalar_index (void) const |
|
|
294 { return rep->valid_as_scalar_index (); } |
|
|
295 |
|
|
296 virtual bool valid_as_zero_index (void) const |
|
|
297 { return rep->valid_as_zero_index (); } |
|
|
298 |
|
|
299 // Does this constant correspond to a truth value? |
|
|
300 |
|
|
301 virtual bool is_true (void) const |
|
|
302 { return rep->is_true (); } |
|
|
303 |
|
|
304 // Is at least one of the dimensions of this constant zero? |
|
|
305 |
|
|
306 virtual bool is_empty (void) const |
|
|
307 { return rep->is_empty (); } |
|
|
308 |
|
|
309 // Are the dimensions of this constant zero by zero? |
|
|
310 |
|
|
311 virtual bool is_zero_by_zero (void) const |
|
|
312 { return rep->is_zero_by_zero (); } |
|
|
313 |
|
|
314 // Values. |
|
|
315 |
|
|
316 virtual double double_value (bool frc_str_conv = false) const |
|
|
317 { return rep->double_value (frc_str_conv); } |
|
|
318 |
|
|
319 virtual Matrix matrix_value (bool frc_str_conv = false) const |
|
|
320 { return rep->matrix_value (frc_str_conv); } |
|
|
321 |
|
|
322 virtual Complex complex_value (bool frc_str_conv = false) const |
|
|
323 { return rep->complex_value (frc_str_conv); } |
|
|
324 |
|
|
325 virtual ComplexMatrix complex_matrix_value (bool frc_str_conv = false) const |
|
|
326 { return rep->complex_matrix_value (frc_str_conv); } |
|
|
327 |
|
|
328 virtual charMatrix char_matrix_value (bool frc_str_conv = false) const |
|
|
329 { return rep->char_matrix_value (frc_str_conv); } |
|
|
330 |
|
|
331 virtual charMatrix all_strings (void) const |
|
|
332 { return rep->all_strings (); } |
|
|
333 |
|
|
334 virtual string string_value (void) const |
|
|
335 { return rep->string_value (); } |
|
|
336 |
|
|
337 virtual Range range_value (void) const |
|
|
338 { return rep->range_value (); } |
|
|
339 |
|
|
340 virtual Octave_map map_value (void) const; |
|
|
341 |
|
|
342 // Unary ops. |
|
|
343 |
|
|
344 virtual octave_value not (void) const { return rep->not (); } |
|
|
345 |
|
|
346 virtual octave_value uminus (void) const { return rep->uminus (); } |
|
|
347 |
|
|
348 virtual octave_value transpose (void) const { return rep->transpose (); } |
|
|
349 |
|
|
350 virtual octave_value hermitian (void) const { return rep->hermitian (); } |
|
|
351 |
|
|
352 virtual void increment (void) |
|
|
353 { |
|
|
354 make_unique (); |
|
|
355 rep->increment (); |
|
|
356 } |
|
|
357 |
|
|
358 virtual void decrement (void) |
|
|
359 { |
|
|
360 make_unique (); |
|
|
361 rep->decrement (); |
|
|
362 } |
|
|
363 |
|
|
364 #if 0 |
|
|
365 virtual octave_value |
|
|
366 lookup_map_element (const string& ref, bool insert = false, |
|
|
367 bool silent = false) |
|
|
368 { return lookup_map_element (ref, insert, silent); } |
|
|
369 |
|
|
370 virtual octave_value |
|
|
371 lookup_map_element (SLList<string>& list, bool insert = false, |
|
|
372 bool silent = false) |
|
|
373 { return rep->lookup_map_element (list, insert, silent); } |
|
|
374 #endif |
|
|
375 |
|
|
376 ColumnVector vector_value (bool frc_str_conv = false, |
|
|
377 bool frc_vec_conv = false) const; |
|
|
378 |
|
|
379 ComplexColumnVector |
|
|
380 complex_vector_value (bool frc_str_conv = false, |
|
|
381 bool frc_vec_conv = false) const; |
|
|
382 |
|
|
383 // Conversions. These should probably be private. If a user of this |
|
|
384 // class wants a certain kind of constant, he should simply ask for |
|
|
385 // it, and we should convert it if possible. |
|
|
386 |
|
|
387 virtual octave_value convert_to_str (void) const |
|
|
388 { return rep->convert_to_str (); } |
|
|
389 |
|
|
390 virtual void convert_to_row_or_column_vector (void) |
|
|
391 { rep->convert_to_row_or_column_vector (); } |
|
|
392 |
|
|
393 void print (void); |
|
|
394 |
|
|
395 virtual void print (ostream& os) { rep->print (os); } |
|
|
396 |
|
|
397 void print_with_name (const string& name, bool print_padding = true); |
|
|
398 |
|
|
399 void print_with_name (ostream& os, const string& name, |
|
|
400 bool print_padding = true); |
|
|
401 |
|
|
402 virtual int type_id (void) const { return rep->type_id (); } |
|
|
403 |
|
|
404 virtual string type_name (void) const { return rep->type_name (); } |
|
|
405 |
|
|
406 #if 0 |
|
|
407 octave_value_rep *make_unique_map (void); |
|
|
408 |
|
|
409 // We want to eliminate this, or at least make it private. |
|
|
410 |
|
|
411 virtual octave_value_rep::constant_type const_type (void) const |
|
|
412 { return rep->const_type (); } |
|
|
413 #endif |
|
|
414 |
|
|
415 virtual void convert_to_matrix_type (bool make_complex) |
|
|
416 { rep->convert_to_matrix_type (make_complex); } |
|
|
417 |
|
|
418 // Can we make these go away? |
|
|
419 |
|
|
420 // These need better names, since a range really is a numeric type. |
|
|
421 |
|
|
422 virtual void force_numeric (bool frc_str_conv = false) |
|
|
423 { rep->force_numeric (frc_str_conv); } |
|
|
424 |
|
|
425 octave_value make_numeric (bool) const |
|
|
426 { |
|
|
427 warning ("octave_value::make_numeric() is a no-op"); |
|
|
428 return *this; |
|
|
429 } |
|
|
430 |
|
|
431 #if 0 |
|
|
432 { |
|
|
433 if (is_numeric_type ()) |
|
|
434 return *this; |
|
|
435 else |
|
|
436 return rep->make_numeric (frc_str_conv); |
|
|
437 } |
|
|
438 #endif |
|
|
439 |
|
|
440 bool print_as_scalar (void); |
|
|
441 |
|
|
442 bool print_as_structure (void) { return is_map (); } |
|
|
443 |
|
|
444 // Binary and unary operations. |
|
|
445 |
|
|
446 friend octave_value do_binary_op (octave_value& a, octave_value& b, |
|
|
447 tree_expression::type t); |
|
|
448 |
|
|
449 protected: |
|
|
450 |
|
|
451 octave_value (const octave_xvalue&) : rep (0) { } |
|
|
452 |
|
|
453 private: |
|
|
454 |
|
|
455 union |
|
|
456 { |
|
|
457 octave_value *freeptr; // For custom memory management. |
|
|
458 octave_value *rep; // The real representation. |
|
|
459 int count; // A reference count. |
|
|
460 }; |
|
|
461 }; |
|
|
462 |
|
|
463 // If TRUE, allow assignments like |
|
|
464 // |
|
|
465 // octave> A(1) = 3; A(2) = 5 |
|
|
466 // |
|
|
467 // for A already defined and a matrix type. |
|
|
468 extern bool Vdo_fortran_indexing; |
|
|
469 |
|
|
470 // Should we allow things like: |
|
|
471 // |
|
|
472 // octave> 'abc' + 0 |
|
|
473 // 97 98 99 |
|
|
474 // |
|
|
475 // to happen? A positive value means yes. A negative value means |
|
|
476 // yes, but print a warning message. Zero means it should be |
|
|
477 // considered an error. |
|
|
478 extern int Vimplicit_str_to_num_ok; |
|
|
479 |
|
|
480 // Should we allow silent conversion of complex to real when a real |
|
|
481 // type is what we're really looking for? A positive value means yes. |
|
|
482 // A negative value means yes, but print a warning message. Zero |
|
|
483 // means it should be considered an error. |
|
|
484 extern int Vok_to_lose_imaginary_part; |
|
|
485 |
|
|
486 // If TRUE, create column vectors when doing assignments like: |
|
|
487 // |
|
|
488 // octave> A(1) = 3; A(2) = 5 |
|
|
489 // |
|
|
490 // (for A undefined). Only matters when resize_on_range_error is also |
|
|
491 // TRUE. |
|
|
492 extern bool Vprefer_column_vectors; |
|
|
493 |
|
|
494 // If TRUE, prefer logical (zore-one) indexing over normal indexing |
|
|
495 // when there is a conflice. For example, given a = [2, 3], the |
|
|
496 // expression a ([1, 1]) would return [2 3] (instead of [2 2], which |
|
|
497 // would be returned if prefer_zero_one_indxing were FALSE). |
|
|
498 extern bool Vprefer_zero_one_indexing; |
|
|
499 |
|
|
500 // If TRUE, print the name along with the value. |
|
|
501 extern bool Vprint_answer_id_name; |
|
|
502 |
|
|
503 // Should operations on empty matrices return empty matrices or an |
|
|
504 // error? A positive value means yes. A negative value means yes, |
|
|
505 // but print a warning message. Zero means it should be considered an |
|
|
506 // error. |
|
|
507 extern int Vpropagate_empty_matrices; |
|
|
508 |
|
|
509 // If TRUE, resize matrices when performing and indexed assignment and |
|
|
510 // the indices are outside the current bounds. |
|
|
511 extern bool Vresize_on_range_error; |
|
|
512 |
|
|
513 // How many levels of structure elements should we print? |
|
|
514 extern int Vstruct_levels_to_print; |
|
|
515 |
|
|
516 // Allow divide by zero errors to be suppressed. |
|
|
517 extern bool Vwarn_divide_by_zero; |
|
|
518 |
|
|
519 // Indentation level for structures. |
|
|
520 extern int struct_indent; |
|
|
521 |
|
|
522 extern void symbols_of_value (void); |
|
|
523 |
|
|
524 extern void increment_struct_indent (void); |
|
|
525 extern void decrement_struct_indent (void); |
|
|
526 |
|
|
527 extern octave_value |
|
|
528 do_binary_op (octave_value::binary_op, const octave_value&, |
|
|
529 const octave_value&); |
|
|
530 |
|
|
531 extern void install_types (void); |
|
|
532 |
|
|
533 #endif |
|
|
534 |
|
|
535 /* |
|
|
536 ;; Local Variables: *** |
|
|
537 ;; mode: C++ *** |
|
|
538 ;; End: *** |
|
|
539 */ |
