annotate src/error.h @ 10605:1834132fb50b

allow non-integer ranges as indices conditionally
author John W. Eaton <jwe@octave.org>
date Wed, 05 May 2010 14:20:58 -0400
parents f3b65e1ae355
children 4ab04ea74b08
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
1 /*
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
2
7017
a1dbe9d80eee [project @ 2007-10-12 21:27:11 by jwe]
jwe
parents: 7016
diff changeset
3 Copyright (C) 1993, 1994, 1995, 1996, 1997, 2000, 2001, 2002, 2003,
7353
516ddd88e45a [project @ 2008-01-07 19:32:40 by jwe]
jwe
parents: 7017
diff changeset
4 2004, 2005, 2006, 2007, 2008 John W. Eaton
1
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
5
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
6 This file is part of Octave.
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
7
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
8 Octave is free software; you can redistribute it and/or modify it
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
9 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: 6355
diff changeset
10 Free Software Foundation; either version 3 of the License, or (at your
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6355
diff changeset
11 option) any later version.
1
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
12
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
13 Octave is distributed in the hope that it will be useful, but WITHOUT
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
16 for more details.
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
17
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
18 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: 6355
diff changeset
19 along with Octave; see the file COPYING. If not, see
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6355
diff changeset
20 <http://www.gnu.org/licenses/>.
1
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
21
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
22 */
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
23
383
0b52c68ec81f [project @ 1994-03-09 21:19:44 by jwe]
jwe
parents: 240
diff changeset
24 #if !defined (octave_error_h)
0b52c68ec81f [project @ 1994-03-09 21:19:44 by jwe]
jwe
parents: 240
diff changeset
25 #define octave_error_h 1
1
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
26
6355
7b124b265c34 [project @ 2007-02-25 16:25:52 by jwe]
jwe
parents: 6338
diff changeset
27 #include <cstdarg>
3935
1ea29376e43e [project @ 2002-05-16 05:30:51 by jwe]
jwe
parents: 3815
diff changeset
28 #include <string>
1489
3e705c864019 [project @ 1995-09-28 05:38:26 by jwe]
jwe
parents: 1428
diff changeset
29
10605
1834132fb50b allow non-integer ranges as indices conditionally
John W. Eaton <jwe@octave.org>
parents: 10313
diff changeset
30 class octave_value_list;
1834132fb50b allow non-integer ranges as indices conditionally
John W. Eaton <jwe@octave.org>
parents: 10313
diff changeset
31
1
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
32 #define panic_impossible() \
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
33 panic ("impossible state reached in file `%s' at line %d", \
10313
f3b65e1ae355 untabify src header files
John W. Eaton <jwe@octave.org>
parents: 10160
diff changeset
34 __FILE__, __LINE__)
1
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
35
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
36 extern OCTINTERP_API void reset_error_handler (void);
4318
115bffcecfd3 [project @ 2003-02-13 05:52:16 by jwe]
jwe
parents: 4051
diff changeset
37
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
38 extern OCTINTERP_API int warning_enabled (const std::string& id);
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 5567
diff changeset
39
6338
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
40 extern OCTINTERP_API void vmessage (const char *name, const char *fmt, va_list args);
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
41 extern OCTINTERP_API void message (const char *name, const char *fmt, ...);
6338
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
42
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
43 extern OCTINTERP_API void vusage (const char *fmt, va_list args);
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
44 extern OCTINTERP_API void usage (const char *fmt, ...);
6338
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
45
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
46 extern OCTINTERP_API void vwarning (const char *fmt, va_list args);
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
47 extern OCTINTERP_API void warning (const char *fmt, ...);
6338
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
48
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
49 extern OCTINTERP_API void verror (const char *fmt, va_list args);
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
50 extern OCTINTERP_API void error (const char *fmt, ...);
6338
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
51
9753
892e2aa7bc75 improve error messages by auto-prepending current function name
Jaroslav Hajek <highegg@gmail.com>
parents: 7977
diff changeset
52 extern OCTINTERP_API void verror_with_cfn (const char *fmt, va_list args);
892e2aa7bc75 improve error messages by auto-prepending current function name
Jaroslav Hajek <highegg@gmail.com>
parents: 7977
diff changeset
53 extern OCTINTERP_API void error_with_cfn (const char *fmt, ...);
892e2aa7bc75 improve error messages by auto-prepending current function name
Jaroslav Hajek <highegg@gmail.com>
parents: 7977
diff changeset
54
6338
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
55 extern OCTINTERP_API void vparse_error (const char *fmt, va_list args);
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
56 extern OCTINTERP_API void parse_error (const char *fmt, ...);
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5307
diff changeset
57
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
58 extern OCTINTERP_API void
6338
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
59 vmessage_with_id (const char *id, const char *name, const char *fmt, va_list args);
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
60
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
61 extern OCTINTERP_API void
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5307
diff changeset
62 message_with_id (const char *id, const char *name, const char *fmt, ...);
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5307
diff changeset
63
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
64 extern OCTINTERP_API void
6338
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
65 vusage_with_id (const char *id, const char *fmt, va_list args);
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
66
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
67 extern OCTINTERP_API void
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5307
diff changeset
68 usage_with_id (const char *id, const char *fmt, ...);
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5307
diff changeset
69
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
70 extern OCTINTERP_API void
6338
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
71 vwarning_with_id (const char *id, const char *fmt, va_list args);
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
72
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
73 extern OCTINTERP_API void
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5307
diff changeset
74 warning_with_id (const char *id, const char *fmt, ...);
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5307
diff changeset
75
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
76 extern OCTINTERP_API void
6338
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
77 verror_with_id (const char *id, const char *fmt, va_list args);
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
78
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
79 extern OCTINTERP_API void
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5307
diff changeset
80 error_with_id (const char *id, const char *fmt, ...);
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5307
diff changeset
81
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
82 extern OCTINTERP_API void
9753
892e2aa7bc75 improve error messages by auto-prepending current function name
Jaroslav Hajek <highegg@gmail.com>
parents: 7977
diff changeset
83 verror_with_id_cfn (const char *id, const char *fmt, va_list args);
892e2aa7bc75 improve error messages by auto-prepending current function name
Jaroslav Hajek <highegg@gmail.com>
parents: 7977
diff changeset
84
892e2aa7bc75 improve error messages by auto-prepending current function name
Jaroslav Hajek <highegg@gmail.com>
parents: 7977
diff changeset
85 extern OCTINTERP_API void
892e2aa7bc75 improve error messages by auto-prepending current function name
Jaroslav Hajek <highegg@gmail.com>
parents: 7977
diff changeset
86 error_with_id_cfn (const char *id, const char *fmt, ...);
892e2aa7bc75 improve error messages by auto-prepending current function name
Jaroslav Hajek <highegg@gmail.com>
parents: 7977
diff changeset
87
892e2aa7bc75 improve error messages by auto-prepending current function name
Jaroslav Hajek <highegg@gmail.com>
parents: 7977
diff changeset
88 extern OCTINTERP_API void
6338
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
89 vparse_error_with_id (const char *id, const char *fmt, va_list args);
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
90
ec88b4ab6d10 [project @ 2007-02-22 07:07:19 by jwe]
jwe
parents: 6109
diff changeset
91 extern OCTINTERP_API void
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5307
diff changeset
92 parse_error_with_id (const char *id, const char *fmt, ...);
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5307
diff changeset
93
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
94 extern OCTINTERP_API void panic (const char *fmt, ...) GCC_ATTR_NORETURN;
1
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
95
4732
b484cdca27be [project @ 2004-02-04 04:32:48 by jwe]
jwe
parents: 4699
diff changeset
96 // Helper function for print_usage defined in defun.cc.
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
97 extern OCTINTERP_API void defun_usage_message (const std::string& msg);
4732
b484cdca27be [project @ 2004-02-04 04:32:48 by jwe]
jwe
parents: 4699
diff changeset
98
10605
1834132fb50b allow non-integer ranges as indices conditionally
John W. Eaton <jwe@octave.org>
parents: 10313
diff changeset
99 extern OCTINTERP_API octave_value_list
1834132fb50b allow non-integer ranges as indices conditionally
John W. Eaton <jwe@octave.org>
parents: 10313
diff changeset
100 set_warning_state (const std::string& id, const std::string& state);
1834132fb50b allow non-integer ranges as indices conditionally
John W. Eaton <jwe@octave.org>
parents: 10313
diff changeset
101
1834132fb50b allow non-integer ranges as indices conditionally
John W. Eaton <jwe@octave.org>
parents: 10313
diff changeset
102 extern OCTINTERP_API octave_value_list
1834132fb50b allow non-integer ranges as indices conditionally
John W. Eaton <jwe@octave.org>
parents: 10313
diff changeset
103 set_warning_state (const octave_value_list& args);
1834132fb50b allow non-integer ranges as indices conditionally
John W. Eaton <jwe@octave.org>
parents: 10313
diff changeset
104
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
105 extern OCTINTERP_API void disable_warning (const std::string& id);
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
106 extern OCTINTERP_API void initialize_default_warning_state (void);
5794
1138ced03f14 [project @ 2006-05-08 20:23:04 by jwe]
jwe
parents: 5781
diff changeset
107
7353
516ddd88e45a [project @ 2008-01-07 19:32:40 by jwe]
jwe
parents: 7017
diff changeset
108 // TRUE means that Octave will try to enter the debugger when an error
516ddd88e45a [project @ 2008-01-07 19:32:40 by jwe]
jwe
parents: 7017
diff changeset
109 // is encountered. This will also inhibit printing of the normal
516ddd88e45a [project @ 2008-01-07 19:32:40 by jwe]
jwe
parents: 7017
diff changeset
110 // traceback message (you will only see the top-level error message).
516ddd88e45a [project @ 2008-01-07 19:32:40 by jwe]
jwe
parents: 7017
diff changeset
111 extern OCTINTERP_API bool Vdebug_on_error;
516ddd88e45a [project @ 2008-01-07 19:32:40 by jwe]
jwe
parents: 7017
diff changeset
112
516ddd88e45a [project @ 2008-01-07 19:32:40 by jwe]
jwe
parents: 7017
diff changeset
113 // TRUE means that Octave will try to enter the debugger when a warning
516ddd88e45a [project @ 2008-01-07 19:32:40 by jwe]
jwe
parents: 7017
diff changeset
114 // is encountered.
516ddd88e45a [project @ 2008-01-07 19:32:40 by jwe]
jwe
parents: 7017
diff changeset
115 extern OCTINTERP_API bool Vdebug_on_warning;
516ddd88e45a [project @ 2008-01-07 19:32:40 by jwe]
jwe
parents: 7017
diff changeset
116
143
7849db4b6dbc [project @ 1993-10-04 02:36:45 by jwe]
jwe
parents: 104
diff changeset
117 // Current error state.
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
118 extern OCTINTERP_API int error_state;
143
7849db4b6dbc [project @ 1993-10-04 02:36:45 by jwe]
jwe
parents: 104
diff changeset
119
3489
cbee5fbb696d [project @ 2000-01-28 09:14:32 by jwe]
jwe
parents: 3018
diff changeset
120 // Current warning state.
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
121 extern OCTINTERP_API int warning_state;
3489
cbee5fbb696d [project @ 2000-01-28 09:14:32 by jwe]
jwe
parents: 3018
diff changeset
122
1489
3e705c864019 [project @ 1995-09-28 05:38:26 by jwe]
jwe
parents: 1428
diff changeset
123 // Tell the error handler whether to print messages, or just store
3e705c864019 [project @ 1995-09-28 05:38:26 by jwe]
jwe
parents: 1428
diff changeset
124 // them for later. Used for handling errors in eval() and
3e705c864019 [project @ 1995-09-28 05:38:26 by jwe]
jwe
parents: 1428
diff changeset
125 // the `unwind_protect' statement.
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
126 extern OCTINTERP_API int buffer_error_messages;
1489
3e705c864019 [project @ 1995-09-28 05:38:26 by jwe]
jwe
parents: 1428
diff changeset
127
3815
c554ad71bafc [project @ 2001-04-19 19:50:52 by jwe]
jwe
parents: 3811
diff changeset
128 // TRUE means error messages are turned off.
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
129 extern OCTINTERP_API bool discard_error_messages;
3815
c554ad71bafc [project @ 2001-04-19 19:50:52 by jwe]
jwe
parents: 3811
diff changeset
130
4452
f3c21a1d1c62 [project @ 2003-07-09 23:20:18 by jwe]
jwe
parents: 4318
diff changeset
131 // TRUE means warning messages are turned off.
6109
c68896f193e3 [project @ 2006-10-27 02:16:18 by jwe]
jwe
parents: 5904
diff changeset
132 extern OCTINTERP_API bool discard_warning_messages;
4452
f3c21a1d1c62 [project @ 2003-07-09 23:20:18 by jwe]
jwe
parents: 4318
diff changeset
133
7977
065c28e1c368 Modify Fcellfun to directly access the error message/id rather than use a call to Flasterr
David Bateman <dbateman@free.fr>
parents: 7353
diff changeset
134 // Helper functions to pass last error and warning messages and ids
065c28e1c368 Modify Fcellfun to directly access the error message/id rather than use a call to Flasterr
David Bateman <dbateman@free.fr>
parents: 7353
diff changeset
135 extern OCTINTERP_API std::string last_error_message (void);
065c28e1c368 Modify Fcellfun to directly access the error message/id rather than use a call to Flasterr
David Bateman <dbateman@free.fr>
parents: 7353
diff changeset
136 extern OCTINTERP_API std::string last_error_id (void);
065c28e1c368 Modify Fcellfun to directly access the error message/id rather than use a call to Flasterr
David Bateman <dbateman@free.fr>
parents: 7353
diff changeset
137 extern OCTINTERP_API std::string last_warning_message (void);
065c28e1c368 Modify Fcellfun to directly access the error message/id rather than use a call to Flasterr
David Bateman <dbateman@free.fr>
parents: 7353
diff changeset
138 extern OCTINTERP_API std::string last_warning_id (void);
065c28e1c368 Modify Fcellfun to directly access the error message/id rather than use a call to Flasterr
David Bateman <dbateman@free.fr>
parents: 7353
diff changeset
139
1
78fd87e624cb [project @ 1993-08-08 01:13:40 by jwe]
jwe
parents:
diff changeset
140 #endif