annotate src/defun-int.h @ 3258:4964d5391acc

[project @ 1999-07-21 21:51:33 by jwe]
author jwe
date Wed, 21 Jul 1999 21:52:04 +0000
parents 60866c521b92
children 35a6d027772c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
525
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
1 /*
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
2
2847
8b262e771614 [project @ 1997-03-27 16:18:26 by jwe]
jwe
parents: 2405
diff changeset
3 Copyright (C) 1996, 1997 John W. Eaton
525
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
4
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
5 This file is part of Octave.
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
6
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
7 Octave is free software; you can redistribute it and/or modify it
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
8 under the terms of the GNU General Public License as published by the
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
9 Free Software Foundation; either version 2, or (at your option) any
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
10 later version.
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
11
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
12 Octave is distributed in the hope that it will be useful, but WITHOUT
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
13 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
15 for more details.
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
16
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
17 You should have received a copy of the GNU General Public License
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
18 along with Octave; see the file COPYING. If not, write to the Free
1315
611d403c7f3d [project @ 1995-06-25 19:56:32 by jwe]
jwe
parents: 1009
diff changeset
19 Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
525
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
20
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
21 */
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
22
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
23 #if !defined (octave_defun_int_h)
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
24 #define octave_defun_int_h 1
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
25
2968
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
26 #include <string>
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
27
3145
0d640dc625c7 [project @ 1998-02-05 08:44:59 by jwe]
jwe
parents: 3096
diff changeset
28 #include "ov-builtin.h"
0d640dc625c7 [project @ 1998-02-05 08:44:59 by jwe]
jwe
parents: 3096
diff changeset
29 #include "ov-mapper.h"
0d640dc625c7 [project @ 1998-02-05 08:44:59 by jwe]
jwe
parents: 3096
diff changeset
30 #include "symtab.h"
3015
2e114e914b77 [project @ 1997-06-02 21:03:55 by jwe]
jwe
parents: 3014
diff changeset
31 #include "version.h"
2e114e914b77 [project @ 1997-06-02 21:03:55 by jwe]
jwe
parents: 3014
diff changeset
32
2968
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
33 class octave_value;
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
34
3014
38de16594cb4 [project @ 1997-06-02 20:28:09 by jwe]
jwe
parents: 3005
diff changeset
35 extern void print_usage (const string& nm, bool just_usage = false);
38de16594cb4 [project @ 1997-06-02 20:28:09 by jwe]
jwe
parents: 3005
diff changeset
36
3015
2e114e914b77 [project @ 1997-06-02 21:03:55 by jwe]
jwe
parents: 3014
diff changeset
37 extern void check_version (const string& version, const string& fcn);
2e114e914b77 [project @ 1997-06-02 21:03:55 by jwe]
jwe
parents: 3014
diff changeset
38
3145
0d640dc625c7 [project @ 1998-02-05 08:44:59 by jwe]
jwe
parents: 3096
diff changeset
39 extern void
0d640dc625c7 [project @ 1998-02-05 08:44:59 by jwe]
jwe
parents: 3096
diff changeset
40 install_builtin_mapper (octave_mapper *mf);
2968
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
41
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
42 extern void
3145
0d640dc625c7 [project @ 1998-02-05 08:44:59 by jwe]
jwe
parents: 3096
diff changeset
43 install_builtin_function (octave_builtin::fcn f, const string& name,
0d640dc625c7 [project @ 1998-02-05 08:44:59 by jwe]
jwe
parents: 3096
diff changeset
44 const string& doc, bool is_text_fcn = false);
2968
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
45
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
46 extern void
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
47 install_builtin_variable (const string& n, const octave_value& v,
3258
4964d5391acc [project @ 1999-07-21 21:51:33 by jwe]
jwe
parents: 3249
diff changeset
48 bool p, bool e,
3145
0d640dc625c7 [project @ 1998-02-05 08:44:59 by jwe]
jwe
parents: 3096
diff changeset
49 symbol_record::change_function chg_fcn,
2968
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
50 const string& h);
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
51
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
52 extern void
3258
4964d5391acc [project @ 1999-07-21 21:51:33 by jwe]
jwe
parents: 3249
diff changeset
53 install_builtin_constant (const string& n, const octave_value& v,
4964d5391acc [project @ 1999-07-21 21:51:33 by jwe]
jwe
parents: 3249
diff changeset
54 bool p, const string& h);
4964d5391acc [project @ 1999-07-21 21:51:33 by jwe]
jwe
parents: 3249
diff changeset
55
4964d5391acc [project @ 1999-07-21 21:51:33 by jwe]
jwe
parents: 3249
diff changeset
56 extern void
2968
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
57 alias_builtin (const string& alias, const string& name);
2405
e6adec89527e [project @ 1996-10-14 16:23:48 by jwe]
jwe
parents: 2086
diff changeset
58
550
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
59 // MAKE_BUILTINS is defined to extract function names and related
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
60 // information and create the *.def files that are eventually used to
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
61 // create the buitlins.cc file.
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
62
525
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
63 #ifdef MAKE_BUILTINS
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
64
550
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
65 // Generate code to install name in the symbol table. The script
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
66 // mkdefs will create a .def file for every .cc file that uses DEFUN,
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
67 // DEFUN_TEXT, or DEFUN_DLD.
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
68
1957
0e6a0a271998 [project @ 1996-02-15 01:08:15 by jwe]
jwe
parents: 1884
diff changeset
69 #define DEFUN_INTERNAL(name, args_name, nargout_name, is_text_fcn, doc) \
525
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
70 BEGIN_INSTALL_BUILTIN \
1957
0e6a0a271998 [project @ 1996-02-15 01:08:15 by jwe]
jwe
parents: 1884
diff changeset
71 extern DECLARE_FUN (name, args_name, nargout_name); \
2968
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
72 install_builtin_function (F ## name, #name, doc, is_text_fcn); \
525
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
73 END_INSTALL_BUILTIN
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
74
550
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
75 // Generate code for making another name for an existing function.
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
76
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
77 #define DEFALIAS_INTERNAL(alias, name) \
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
78 BEGIN_INSTALL_BUILTIN \
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
79 alias_builtin (#alias, #name); \
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
80 END_INSTALL_BUILTIN
525
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
81
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
82 #else /* ! MAKE_BUILTINS */
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
83
550
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
84 // Generate the first line of the function definition. This ensures
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
85 // that the internal functions all have the same signature.
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
86
1957
0e6a0a271998 [project @ 1996-02-15 01:08:15 by jwe]
jwe
parents: 1884
diff changeset
87 #define DEFUN_INTERNAL(name, args_name, nargout_name, is_text_fcn, doc) \
0e6a0a271998 [project @ 1996-02-15 01:08:15 by jwe]
jwe
parents: 1884
diff changeset
88 DECLARE_FUN (name, args_name, nargout_name)
525
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
89
550
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
90 // No definition is required for an alias.
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
91
95ee5e330179 [project @ 1994-07-22 20:17:58 by jwe]
jwe
parents: 540
diff changeset
92 #define DEFALIAS_INTERNAL(name, alias)
525
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
93
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
94 #endif /* ! MAKE_BUILTINS */
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
95
3092
4bb976b250bf [project @ 1997-10-17 07:48:48 by jwe]
jwe
parents: 3015
diff changeset
96 // Define the code that will be used to insert the new function into
703
21cc5b9b9ed6 [project @ 1994-09-15 02:39:57 by jwe]
jwe
parents: 578
diff changeset
97 // the symbol table.
21cc5b9b9ed6 [project @ 1994-09-15 02:39:57 by jwe]
jwe
parents: 578
diff changeset
98
2968
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
99 #define DEFINE_FUN_INSTALLER_FUN(name, doc) \
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
100 bool \
1957
0e6a0a271998 [project @ 1996-02-15 01:08:15 by jwe]
jwe
parents: 1884
diff changeset
101 FS ## name (void) \
703
21cc5b9b9ed6 [project @ 1994-09-15 02:39:57 by jwe]
jwe
parents: 578
diff changeset
102 { \
2968
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
103 static bool installed = false; \
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
104 if (! installed) \
3015
2e114e914b77 [project @ 1997-06-02 21:03:55 by jwe]
jwe
parents: 3014
diff changeset
105 { \
2e114e914b77 [project @ 1997-06-02 21:03:55 by jwe]
jwe
parents: 3014
diff changeset
106 check_version (OCTAVE_VERSION, #name); \
2e114e914b77 [project @ 1997-06-02 21:03:55 by jwe]
jwe
parents: 3014
diff changeset
107 install_builtin_function (F ## name, #name, doc); \
3096
ff8b4d6371b3 [project @ 1997-11-14 07:59:14 by jwe]
jwe
parents: 3092
diff changeset
108 installed = true; \
3015
2e114e914b77 [project @ 1997-06-02 21:03:55 by jwe]
jwe
parents: 3014
diff changeset
109 } \
2968
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
110 return installed; \
703
21cc5b9b9ed6 [project @ 1994-09-15 02:39:57 by jwe]
jwe
parents: 578
diff changeset
111 }
21cc5b9b9ed6 [project @ 1994-09-15 02:39:57 by jwe]
jwe
parents: 578
diff changeset
112
1957
0e6a0a271998 [project @ 1996-02-15 01:08:15 by jwe]
jwe
parents: 1884
diff changeset
113 #define DECLARE_FUN(name, args_name, nargout_name) \
2968
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
114 octave_value_list \
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
115 F ## name (const octave_value_list& args_name, int nargout_name)
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
116
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
117 // How builtin variables are actually installed.
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
118
3258
4964d5391acc [project @ 1999-07-21 21:51:33 by jwe]
jwe
parents: 3249
diff changeset
119 #define DEFVAR_INTERNAL(name, sname, defn, protect, chg_fcn, doc) \
4964d5391acc [project @ 1999-07-21 21:51:33 by jwe]
jwe
parents: 3249
diff changeset
120 install_builtin_variable (name, octave_value (defn), protect, \
4964d5391acc [project @ 1999-07-21 21:51:33 by jwe]
jwe
parents: 3249
diff changeset
121 (chg_fcn != 0), chg_fcn, doc)
4964d5391acc [project @ 1999-07-21 21:51:33 by jwe]
jwe
parents: 3249
diff changeset
122
4964d5391acc [project @ 1999-07-21 21:51:33 by jwe]
jwe
parents: 3249
diff changeset
123 // How builtin variables are actually installed.
4964d5391acc [project @ 1999-07-21 21:51:33 by jwe]
jwe
parents: 3249
diff changeset
124
4964d5391acc [project @ 1999-07-21 21:51:33 by jwe]
jwe
parents: 3249
diff changeset
125 #define DEFCONST_INTERNAL(name, sname, defn, protect, doc) \
4964d5391acc [project @ 1999-07-21 21:51:33 by jwe]
jwe
parents: 3249
diff changeset
126 install_builtin_constant (name, octave_value (defn), protect, doc)
2968
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
127
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
128 // How mapper functions are actually installed.
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
129
3249
60866c521b92 [project @ 1999-07-13 03:44:16 by jwe]
jwe
parents: 3145
diff changeset
130 #define DEFUN_MAPPER_INTERNAL(name, ch_map, d_b_map, c_b_map, d_d_map, \
60866c521b92 [project @ 1999-07-13 03:44:16 by jwe]
jwe
parents: 3145
diff changeset
131 d_c_map, c_c_map, lo, hi, \
60866c521b92 [project @ 1999-07-13 03:44:16 by jwe]
jwe
parents: 3145
diff changeset
132 can_ret_cmplx_for_real, doc) \
2968
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
133 install_builtin_mapper \
3249
60866c521b92 [project @ 1999-07-13 03:44:16 by jwe]
jwe
parents: 3145
diff changeset
134 (new octave_mapper (ch_map, d_b_map, c_b_map, d_d_map, d_c_map, \
60866c521b92 [project @ 1999-07-13 03:44:16 by jwe]
jwe
parents: 3145
diff changeset
135 c_c_map, lo, hi, \
2968
e330cb788508 [project @ 1997-05-15 17:40:29 by jwe]
jwe
parents: 2954
diff changeset
136 can_ret_cmplx_for_real, #name))
525
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
137
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
138 #endif
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
139
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
140 /*
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
141 ;;; Local Variables: ***
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
142 ;;; mode: C++ ***
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
143 ;;; End: ***
509e9a2d93a6 [project @ 1994-07-20 18:45:27 by jwe]
jwe
parents:
diff changeset
144 */