annotate libinterp/corefcn/load-save.h @ 20614:10ec79b47808

use new string_value method to handle value extraction errors * __voronoi__.cc, chol.cc, colamd.cc, fftw.cc: Use new string_value method.
author John W. Eaton <jwe@octave.org>
date Thu, 08 Oct 2015 18:15:56 -0400
parents c6224b4e7774
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
606
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
1 /*
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
2
19731
4197fc428c7d maint: Update copyright notices for 2015.
John W. Eaton <jwe@octave.org>
parents: 17787
diff changeset
3 Copyright (C) 1994-2015 John W. Eaton
606
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
4
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
5 This file is part of Octave.
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
6
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
7 Octave is free software; you can redistribute it and/or modify it
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
8 under the terms of the GNU General Public License as published by the
7016
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6974
diff changeset
9 Free Software Foundation; either version 3 of the License, or (at your
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6974
diff changeset
10 option) any later version.
606
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
11
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
12 Octave is distributed in the hope that it will be useful, but WITHOUT
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
13 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
15 for more details.
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
16
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
17 You should have received a copy of the GNU General Public License
7016
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6974
diff changeset
18 along with Octave; see the file COPYING. If not, see
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6974
diff changeset
19 <http://www.gnu.org/licenses/>.
606
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
20
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
21 */
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
22
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
23 #if !defined (octave_load_save_h)
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
24 #define octave_load_save_h 1
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
25
8950
d865363208d6 include <iosfwd> instead of <iostream> in header files
John W. Eaton <jwe@octave.org>
parents: 8920
diff changeset
26 #include <iosfwd>
3503
d14c483b3c12 [project @ 2000-02-01 04:06:07 by jwe]
jwe
parents: 2907
diff changeset
27 #include <string>
1738
bb9d00aa55fb [project @ 1996-01-12 10:56:22 by jwe]
jwe
parents: 1380
diff changeset
28
16555
04fb96f4bea1 allow double-click in file browser to load data files
John W. Eaton <jwe@octave.org>
parents: 15420
diff changeset
29 #include "mach-info.h"
04fb96f4bea1 allow double-click in file browser to load data files
John W. Eaton <jwe@octave.org>
parents: 15420
diff changeset
30 #include "symtab.h"
04fb96f4bea1 allow double-click in file browser to load data files
John W. Eaton <jwe@octave.org>
parents: 15420
diff changeset
31
2086
bfb775fb6fe8 [project @ 1996-04-25 05:55:19 by jwe]
jwe
parents: 1996
diff changeset
32 class octave_value;
606
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
33
8425
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
34 // FIXME: maybe MAT5 and MAT7 should be options to MAT_BINARY.
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
35 // Similarly, save_as_floats may be an option for LS_BINARY, LS_HDF5 etc.
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
36 enum load_save_format_type
17787
175b392e91fe Use GNU style coding conventions for code in libinterp/
Rik <rik@octave.org>
parents: 17755
diff changeset
37 {
20482
c6224b4e7774 maint: Rename instances of LS_ASCII to LS_TEXT for clarity.
Rik <rik@octave.org>
parents: 19897
diff changeset
38 LS_TEXT,
17787
175b392e91fe Use GNU style coding conventions for code in libinterp/
Rik <rik@octave.org>
parents: 17755
diff changeset
39 LS_BINARY,
175b392e91fe Use GNU style coding conventions for code in libinterp/
Rik <rik@octave.org>
parents: 17755
diff changeset
40 LS_MAT_ASCII,
175b392e91fe Use GNU style coding conventions for code in libinterp/
Rik <rik@octave.org>
parents: 17755
diff changeset
41 LS_MAT_BINARY,
175b392e91fe Use GNU style coding conventions for code in libinterp/
Rik <rik@octave.org>
parents: 17755
diff changeset
42 LS_MAT5_BINARY,
175b392e91fe Use GNU style coding conventions for code in libinterp/
Rik <rik@octave.org>
parents: 17755
diff changeset
43 LS_MAT7_BINARY,
175b392e91fe Use GNU style coding conventions for code in libinterp/
Rik <rik@octave.org>
parents: 17755
diff changeset
44 LS_HDF5,
175b392e91fe Use GNU style coding conventions for code in libinterp/
Rik <rik@octave.org>
parents: 17755
diff changeset
45 LS_UNKNOWN
175b392e91fe Use GNU style coding conventions for code in libinterp/
Rik <rik@octave.org>
parents: 17755
diff changeset
46 };
4329
d53c33d93440 [project @ 2003-02-18 20:00:48 by jwe]
jwe
parents: 3738
diff changeset
47
8425
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
48 enum load_save_format_options
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
49 {
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
50 // LS_MAT_ASCII options (not exclusive)
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
51 LS_MAT_ASCII_LONG = 1,
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
52 LS_MAT_ASCII_TABS = 2,
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
53 // LS_MAT_BINARY options
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
54 LS_MAT_BINARY_V5 = 1,
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
55 LS_MAT_BINARY_V7,
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
56 // zero means no option.
11586
12df7854fa7c strip trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
57 LS_NO_OPTION = 0
8425
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
58 };
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
59
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
60 class load_save_format
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
61 {
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
62 public:
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
63 load_save_format (load_save_format_type t,
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
64 load_save_format_options o = LS_NO_OPTION)
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
65 : type (t), opts (o) { }
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
66 operator int (void) const
17787
175b392e91fe Use GNU style coding conventions for code in libinterp/
Rik <rik@octave.org>
parents: 17755
diff changeset
67 { return type; }
8425
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
68 int type, opts;
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
69 };
2e777f5135a3 support -tabs option for save -ascii
Jaroslav Hajek <highegg@gmail.com>
parents: 7336
diff changeset
70
4791
62f2fb593455 [project @ 2004-02-20 18:02:59 by jwe]
jwe
parents: 4687
diff changeset
71 extern void dump_octave_core (void);
4329
d53c33d93440 [project @ 2003-02-18 20:00:48 by jwe]
jwe
parents: 3738
diff changeset
72
d53c33d93440 [project @ 2003-02-18 20:00:48 by jwe]
jwe
parents: 3738
diff changeset
73 extern int
d53c33d93440 [project @ 2003-02-18 20:00:48 by jwe]
jwe
parents: 3738
diff changeset
74 read_binary_file_header (std::istream& is, bool& swap,
10313
f3b65e1ae355 untabify src header files
John W. Eaton <jwe@octave.org>
parents: 10160
diff changeset
75 oct_mach_info::float_format& flt_fmt,
f3b65e1ae355 untabify src header files
John W. Eaton <jwe@octave.org>
parents: 10160
diff changeset
76 bool quiet = false);
606
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
77
4329
d53c33d93440 [project @ 2003-02-18 20:00:48 by jwe]
jwe
parents: 3738
diff changeset
78 extern octave_value
13273
58c4d02c8ba2 fix declaration of do_load in load-save.h
John W. Eaton <jwe@octave.org>
parents: 11586
diff changeset
79 do_load (std::istream& stream, const std::string& orig_fname,
10313
f3b65e1ae355 untabify src header files
John W. Eaton <jwe@octave.org>
parents: 10160
diff changeset
80 load_save_format format, oct_mach_info::float_format flt_fmt,
f3b65e1ae355 untabify src header files
John W. Eaton <jwe@octave.org>
parents: 10160
diff changeset
81 bool list_only, bool swap, bool verbose,
f3b65e1ae355 untabify src header files
John W. Eaton <jwe@octave.org>
parents: 10160
diff changeset
82 const string_vector& argv, int argv_idx, int argc, int nargout);
4329
d53c33d93440 [project @ 2003-02-18 20:00:48 by jwe]
jwe
parents: 3738
diff changeset
83
16625
a86a14e6e65e Decorate symbols with OCTINTERP_API.
Michael Goffioul <michael.goffioul@gmail.com>
parents: 16555
diff changeset
84 extern OCTINTERP_API bool is_octave_data_file (const std::string& file);
16555
04fb96f4bea1 allow double-click in file browser to load data files
John W. Eaton <jwe@octave.org>
parents: 15420
diff changeset
85
4329
d53c33d93440 [project @ 2003-02-18 20:00:48 by jwe]
jwe
parents: 3738
diff changeset
86 extern void
7336
745a8299c2b5 [project @ 2007-12-28 20:56:55 by jwe]
jwe
parents: 7017
diff changeset
87 do_save (std::ostream& os, const symbol_table::symbol_record& sr,
10313
f3b65e1ae355 untabify src header files
John W. Eaton <jwe@octave.org>
parents: 10160
diff changeset
88 load_save_format fmt, bool save_as_floats);
4329
d53c33d93440 [project @ 2003-02-18 20:00:48 by jwe]
jwe
parents: 3738
diff changeset
89
d53c33d93440 [project @ 2003-02-18 20:00:48 by jwe]
jwe
parents: 3738
diff changeset
90 extern void
d53c33d93440 [project @ 2003-02-18 20:00:48 by jwe]
jwe
parents: 3738
diff changeset
91 write_header (std::ostream& os, load_save_format format);
1380
79f80c6229be [project @ 1995-09-12 07:03:33 by jwe]
jwe
parents: 1315
diff changeset
92
17755
9c03b071fd7b avoid HDF5 error message at exit (bug #37713)
John W. Eaton <jwe@octave.org>
parents: 17744
diff changeset
93 extern void octave_prepare_hdf5 (void);
9c03b071fd7b avoid HDF5 error message at exit (bug #37713)
John W. Eaton <jwe@octave.org>
parents: 17744
diff changeset
94
9c03b071fd7b avoid HDF5 error message at exit (bug #37713)
John W. Eaton <jwe@octave.org>
parents: 17744
diff changeset
95 extern void octave_finalize_hdf5 (void);
9c03b071fd7b avoid HDF5 error message at exit (bug #37713)
John W. Eaton <jwe@octave.org>
parents: 17744
diff changeset
96
606
91ab3cfc2376 [project @ 1994-08-13 20:11:17 by jwe]
jwe
parents:
diff changeset
97 #endif