|
5864
|
1 /* |
|
|
2 |
|
|
3 Copyright (C) 2006 Paul Kienzle |
|
|
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, Inc., 51 Franklin Street, Fifth Floor, Boston, MA |
|
|
20 02110-1301, USA. |
|
|
21 |
|
|
22 */ |
|
|
23 |
|
|
24 /* |
|
|
25 |
|
|
26 This code was originally distributed as part of Octave Forge under |
|
|
27 the follwoing terms: |
|
|
28 |
|
|
29 Author: Paul Kienzle |
|
|
30 I grant this code to the public domain. |
|
|
31 2001-03-22 |
|
|
32 |
|
|
33 THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND |
|
|
34 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
|
|
35 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
|
|
36 ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE |
|
|
37 FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
|
|
38 DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS |
|
|
39 OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) |
|
|
40 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT |
|
|
41 LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY |
|
|
42 OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
|
|
43 SUCH DAMAGE. |
|
|
44 |
|
|
45 */ |
|
|
46 |
|
|
47 /* mex.h is for use in C-programs only; do NOT include it in mex.cc */ |
|
|
48 |
|
|
49 #if ! defined (MEXPROTO_H) |
|
|
50 #define MEXPROTO_H |
|
|
51 |
|
|
52 #if defined (__cplusplus) |
|
5900
|
53 #include <cstdlib> |
|
5864
|
54 extern "C" { |
|
5900
|
55 #else |
|
|
56 #include <stdlib.h> |
|
5864
|
57 #endif |
|
|
58 |
|
5900
|
59 #define MXARRAY_TYPEDEFS_ONLY |
|
|
60 #include "mxarray.h" |
|
|
61 #undef MXARRAY_TYPEDEFS_ONLY |
|
|
62 |
|
|
63 // Interface to the interpreter. |
|
5864
|
64 extern const char *mexFunctionName (void); |
|
|
65 |
|
|
66 extern int mexCallMATLAB (int nargout, mxArray *argout[], int nargin, |
|
|
67 mxArray *argin[], const char *fname); |
|
|
68 |
|
|
69 extern void mexSetTrapFlag (int flag); |
|
|
70 extern int mexEvalString (const char *s); |
|
|
71 extern void mexErrMsgTxt (const char *s); |
|
5879
|
72 extern void mexErrMsgIdAndTxt (const char *id, const char *s); |
|
5864
|
73 extern void mexWarnMsgTxt (const char *s); |
|
5879
|
74 extern void mexWarnMsgIdAndTxt (const char *id, const char *s); |
|
5864
|
75 extern void mexPrintf (const char *fmt, ...); |
|
|
76 |
|
5879
|
77 extern mxArray *mexGetVariable (const char *space, const char *name); |
|
|
78 extern const mxArray *mexGetVariablePtr (const char *space, const char *name); |
|
5864
|
79 |
|
|
80 extern int mexPutVariable (const char *space, const char *name, mxArray *ptr); |
|
|
81 |
|
|
82 extern void mexMakeArrayPersistent (mxArray *ptr); |
|
|
83 extern void mexMakeMemoryPersistent (void *ptr); |
|
5879
|
84 |
|
|
85 extern int mexAtExit (void (*f) (void)); |
|
|
86 extern const mxArray *mexGet (double handle, const char *property); |
|
|
87 extern int mexIsGlobal (const mxArray *ptr); |
|
|
88 extern int mexIsLocked (void); |
|
|
89 extern void mexLock (void); |
|
|
90 extern int mexSet (double handle, const char *property, mxArray *val); |
|
|
91 extern void mexUnlock (void); |
|
5900
|
92 |
|
|
93 // Floating point predicates. |
|
|
94 extern int mxIsFinite (double v); |
|
|
95 extern int mxIsInf (double v); |
|
|
96 extern int mxIsNaN (double v); |
|
|
97 |
|
|
98 // Floating point values. |
|
|
99 extern double mxGetEps (void); |
|
|
100 extern double mxGetInf (void); |
|
|
101 extern double mxGetNaN (void); |
|
|
102 |
|
|
103 // Memory management. |
|
|
104 extern void *mxCalloc (size_t n, size_t size); |
|
|
105 extern void *mxMalloc (size_t n); |
|
|
106 extern void *mxRealloc (void *ptr, size_t size); |
|
|
107 extern void mxFree (void *ptr); |
|
|
108 |
|
|
109 // Constructors. |
|
|
110 extern mxArray *mxCreateCellArray (int ndims, const int *dims); |
|
|
111 extern mxArray *mxCreateCellMatrix (int m, int n); |
|
|
112 extern mxArray *mxCreateCharArray (int ndims, const int *dims); |
|
|
113 extern mxArray *mxCreateCharMatrixFromStrings (int m, const char **str); |
|
|
114 extern mxArray *mxCreateDoubleMatrix (int nr, int nc, mxComplexity flag); |
|
|
115 extern mxArray *mxCreateDoubleScalar (double val); |
|
|
116 extern mxArray *mxCreateLogicalArray (int ndims, const int *dims); |
|
|
117 extern mxArray *mxCreateLogicalMatrix (int m, int n); |
|
|
118 extern mxArray *mxCreateLogicalScalar (int val); |
|
|
119 extern mxArray *mxCreateNumericArray (int ndims, const int *dims, mxClassID class_id, mxComplexity flag); |
|
|
120 extern mxArray *mxCreateNumericMatrix (int m, int n, mxClassID class_id, mxComplexity flag); |
|
|
121 extern mxArray *mxCreateSparse (int m, int n, int nzmax, mxComplexity flag); |
|
|
122 extern mxArray *mxCreateSparseLogicalMatrix (int m, int n, int nzmax); |
|
|
123 extern mxArray *mxCreateString (const char *str); |
|
|
124 extern mxArray *mxCreateStructArray (int ndims, int *dims, int num_keys, const char **keys); |
|
|
125 extern mxArray *mxCreateStructMatrix (int rows, int cols, int num_keys, const char **keys); |
|
|
126 |
|
|
127 // Copy constructor. |
|
|
128 extern mxArray *mxDuplicateArray (const mxArray *v); |
|
|
129 |
|
|
130 // Destructor. |
|
|
131 extern void mxDestroyArray (mxArray *v); |
|
|
132 |
|
|
133 // Type Predicates. |
|
|
134 extern int mxIsCell (const mxArray *ptr); |
|
|
135 extern int mxIsChar (const mxArray *ptr); |
|
|
136 extern int mxIsClass (const mxArray *ptr, const char *name); |
|
|
137 extern int mxIsComplex (const mxArray *ptr); |
|
|
138 extern int mxIsDouble (const mxArray *ptr); |
|
|
139 extern int mxIsInt16 (const mxArray *ptr); |
|
|
140 extern int mxIsInt32 (const mxArray *ptr); |
|
|
141 extern int mxIsInt64 (const mxArray *ptr); |
|
|
142 extern int mxIsInt8 (const mxArray *ptr); |
|
|
143 extern int mxIsLogical (const mxArray *ptr); |
|
|
144 extern int mxIsNumeric (const mxArray *ptr); |
|
|
145 extern int mxIsSingle (const mxArray *ptr); |
|
|
146 extern int mxIsSparse (const mxArray *ptr); |
|
|
147 extern int mxIsStruct (const mxArray *ptr); |
|
|
148 extern int mxIsUint16 (const mxArray *ptr); |
|
|
149 extern int mxIsUint32 (const mxArray *ptr); |
|
|
150 extern int mxIsUint64 (const mxArray *ptr); |
|
|
151 extern int mxIsUint8 (const mxArray *ptr); |
|
|
152 |
|
|
153 // Odd type+size predicate. |
|
|
154 extern int mxIsLogicalScalar (const mxArray *ptr); |
|
|
155 |
|
|
156 // Odd type+size+value predicate. |
|
|
157 extern int mxIsLogicalScalarTrue (const mxArray *ptr); |
|
|
158 |
|
|
159 // Size predicate. |
|
|
160 extern int mxIsEmpty (const mxArray *ptr); |
|
|
161 |
|
|
162 // Just plain odd thing to ask of a value. |
|
|
163 extern int mxIsFromGlobalWS (const mxArray *ptr); |
|
|
164 |
|
|
165 // Dimension extractors. |
|
|
166 extern int mxGetM (const mxArray *ptr); |
|
|
167 extern int mxGetN (const mxArray *ptr); |
|
|
168 extern int *mxGetDimensions (const mxArray *ptr); |
|
|
169 extern int mxGetNumberOfDimensions (const mxArray *ptr); |
|
|
170 extern int mxGetNumberOfElements (const mxArray *ptr); |
|
|
171 |
|
|
172 // Dimension setters. |
|
|
173 extern void mxSetM (mxArray *ptr, int M); |
|
|
174 extern void mxSetN (mxArray *ptr, int N); |
|
|
175 extern void mxSetDimensions (mxArray *ptr, int *dims, int ndims); |
|
|
176 |
|
|
177 // Data extractors. |
|
|
178 extern double *mxGetPi (const mxArray *ptr); |
|
|
179 extern double *mxGetPr (const mxArray *ptr); |
|
|
180 extern double mxGetScalar (const mxArray *ptr); |
|
|
181 extern mxChar *mxGetChars (const mxArray *ptr); |
|
|
182 extern mxLogical *mxGetLogicals (const mxArray *ptr); |
|
|
183 extern void *mxGetData (const mxArray *ptr); |
|
|
184 extern void *mxGetImagData (const mxArray *ptr); |
|
|
185 |
|
|
186 // Data setters. |
|
|
187 extern void mxSetPr (mxArray *ptr, double *pr); |
|
|
188 extern void mxSetPi (mxArray *ptr, double *pi); |
|
|
189 extern void mxSetData (mxArray *ptr, void *data); |
|
|
190 extern void mxSetImagData (mxArray *ptr, void *pi); |
|
|
191 |
|
|
192 // Classes. |
|
|
193 extern mxClassID mxGetClassID (const mxArray *ptr); |
|
|
194 extern const char *mxGetClassName (const mxArray *ptr); |
|
|
195 |
|
|
196 extern void mxSetClassName (mxArray *ptr, const char *name); |
|
|
197 |
|
|
198 // Cell support. |
|
|
199 extern mxArray *mxGetCell (const mxArray *ptr, int idx); |
|
|
200 |
|
|
201 extern void mxSetCell (mxArray *ptr, int idx, mxArray *val); |
|
|
202 |
|
|
203 // Sparse support. |
|
|
204 extern int *mxGetIr (const mxArray *ptr); |
|
|
205 extern int *mxGetJc (const mxArray *ptr); |
|
|
206 extern int mxGetNzmax (const mxArray *ptr); |
|
|
207 |
|
|
208 extern void mxSetIr (mxArray *ptr, int *ir); |
|
|
209 extern void mxSetJc (mxArray *ptr, int *jc); |
|
|
210 extern void mxSetNzmax (mxArray *ptr, int nzmax); |
|
|
211 |
|
|
212 // Structure support. |
|
|
213 extern int mxAddField (mxArray *ptr, const char *key); |
|
|
214 |
|
|
215 extern void mxRemoveField (mxArray *ptr, int key_num); |
|
|
216 |
|
|
217 extern mxArray *mxGetField (const mxArray *ptr, int index, const char *key); |
|
|
218 extern mxArray *mxGetFieldByNumber (const mxArray *ptr, int index, int key_num); |
|
|
219 |
|
|
220 extern void mxSetField (mxArray *ptr, int index, const char *key, mxArray *val); |
|
|
221 extern void mxSetFieldByNumber (mxArray *ptr, int index, int key_num, mxArray *val); |
|
|
222 |
|
|
223 extern int mxGetNumberOfFields (const mxArray *ptr); |
|
|
224 |
|
|
225 extern const char *mxGetFieldNameByNumber (const mxArray *ptr, int key_num); |
|
|
226 extern int mxGetFieldNumber (const mxArray *ptr, const char *key); |
|
|
227 |
|
|
228 extern int mxGetString (const mxArray *ptr, char *buf, int buflen); |
|
|
229 extern char *mxArrayToString (const mxArray *ptr); |
|
|
230 |
|
|
231 // Miscellaneous. |
|
|
232 #ifdef NDEBUG |
|
|
233 #define mxAssert(expr, msg) \ |
|
|
234 do \ |
|
|
235 { \ |
|
|
236 if (! expr) \ |
|
|
237 { \ |
|
|
238 mexPrintf ("Assertion failed: %s, at line %d of file \"%s\".\n%s\n", \ |
|
|
239 #expr, __LINE__, __FILE__, msg); \ |
|
|
240 } \ |
|
|
241 } \ |
|
|
242 while (0) |
|
|
243 |
|
|
244 #define mxAssertS(expr, msg) \ |
|
|
245 do \ |
|
|
246 { \ |
|
|
247 if (! expr) \ |
|
|
248 { \ |
|
|
249 mexPrintf ("Assertion failed at line %d of file \"%s\".\n%s\n", \ |
|
|
250 __LINE__, __FILE__, msg); \ |
|
|
251 abort (); \ |
|
|
252 } \ |
|
|
253 } \ |
|
|
254 while (0) |
|
|
255 #else |
|
|
256 #define mxAssert(expr, msg) |
|
|
257 #define mxAssertS(expr, msg) |
|
5879
|
258 #endif |
|
|
259 |
|
5900
|
260 extern int mxCalcSingleSubscript (const mxArray *ptr, int nsubs, int *subs); |
|
|
261 |
|
|
262 extern int mxGetElementSize (const mxArray *ptr); |
|
|
263 |
|
5864
|
264 #if defined (__cplusplus) |
|
|
265 } |
|
|
266 #endif |
|
|
267 |
|
|
268 #endif |
|
|
269 |
|
|
270 /* |
|
|
271 ;;; Local Variables: *** |
|
|
272 ;;; mode: C *** |
|
|
273 ;;; End: *** |
|
|
274 */ |
