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 |
6064
|
27 the following terms: |
5864
|
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. |
6109
|
64 extern OCTINTERP_API const char *mexFunctionName (void); |
5864
|
65 |
6109
|
66 extern OCTINTERP_API int mexCallMATLAB (int nargout, mxArray *argout[], int nargin, |
5864
|
67 mxArray *argin[], const char *fname); |
|
68 |
6109
|
69 extern OCTINTERP_API void mexSetTrapFlag (int flag); |
|
70 extern OCTINTERP_API int mexEvalString (const char *s); |
|
71 extern OCTINTERP_API void mexErrMsgTxt (const char *s); |
|
72 extern OCTINTERP_API void mexErrMsgIdAndTxt (const char *id, const char *s); |
|
73 extern OCTINTERP_API void mexWarnMsgTxt (const char *s); |
|
74 extern OCTINTERP_API void mexWarnMsgIdAndTxt (const char *id, const char *s); |
|
75 extern OCTINTERP_API void mexPrintf (const char *fmt, ...); |
5864
|
76 |
6109
|
77 extern OCTINTERP_API mxArray *mexGetVariable (const char *space, const char *name); |
|
78 extern OCTINTERP_API const mxArray *mexGetVariablePtr (const char *space, const char *name); |
5864
|
79 |
6109
|
80 extern OCTINTERP_API int mexPutVariable (const char *space, const char *name, mxArray *ptr); |
5864
|
81 |
6109
|
82 extern OCTINTERP_API void mexMakeArrayPersistent (mxArray *ptr); |
|
83 extern OCTINTERP_API void mexMakeMemoryPersistent (void *ptr); |
5879
|
84 |
6109
|
85 extern OCTINTERP_API int mexAtExit (void (*f) (void)); |
|
86 extern OCTINTERP_API const mxArray *mexGet (double handle, const char *property); |
|
87 extern OCTINTERP_API int mexIsGlobal (const mxArray *ptr); |
|
88 extern OCTINTERP_API int mexIsLocked (void); |
|
89 extern OCTINTERP_API void mexLock (void); |
|
90 extern OCTINTERP_API int mexSet (double handle, const char *property, mxArray *val); |
|
91 extern OCTINTERP_API void mexUnlock (void); |
5900
|
92 |
|
93 // Floating point predicates. |
6109
|
94 extern OCTINTERP_API int mxIsFinite (double v); |
|
95 extern OCTINTERP_API int mxIsInf (double v); |
|
96 extern OCTINTERP_API int mxIsNaN (double v); |
5900
|
97 |
|
98 // Floating point values. |
6109
|
99 extern OCTINTERP_API double mxGetEps (void); |
|
100 extern OCTINTERP_API double mxGetInf (void); |
|
101 extern OCTINTERP_API double mxGetNaN (void); |
5900
|
102 |
|
103 // Memory management. |
6109
|
104 extern OCTINTERP_API void *mxCalloc (size_t n, size_t size); |
|
105 extern OCTINTERP_API void *mxMalloc (size_t n); |
|
106 extern OCTINTERP_API void *mxRealloc (void *ptr, size_t size); |
|
107 extern OCTINTERP_API void mxFree (void *ptr); |
5900
|
108 |
|
109 // Constructors. |
6109
|
110 extern OCTINTERP_API mxArray *mxCreateCellArray (int ndims, const int *dims); |
|
111 extern OCTINTERP_API mxArray *mxCreateCellMatrix (int m, int n); |
|
112 extern OCTINTERP_API mxArray *mxCreateCharArray (int ndims, const int *dims); |
|
113 extern OCTINTERP_API mxArray *mxCreateCharMatrixFromStrings (int m, const char **str); |
|
114 extern OCTINTERP_API mxArray *mxCreateDoubleMatrix (int nr, int nc, mxComplexity flag); |
|
115 extern OCTINTERP_API mxArray *mxCreateDoubleScalar (double val); |
|
116 extern OCTINTERP_API mxArray *mxCreateLogicalArray (int ndims, const int *dims); |
|
117 extern OCTINTERP_API mxArray *mxCreateLogicalMatrix (int m, int n); |
|
118 extern OCTINTERP_API mxArray *mxCreateLogicalScalar (int val); |
|
119 extern OCTINTERP_API mxArray *mxCreateNumericArray (int ndims, const int *dims, mxClassID class_id, mxComplexity flag); |
|
120 extern OCTINTERP_API mxArray *mxCreateNumericMatrix (int m, int n, mxClassID class_id, mxComplexity flag); |
|
121 extern OCTINTERP_API mxArray *mxCreateSparse (int m, int n, int nzmax, mxComplexity flag); |
|
122 extern OCTINTERP_API mxArray *mxCreateSparseLogicalMatrix (int m, int n, int nzmax); |
|
123 extern OCTINTERP_API mxArray *mxCreateString (const char *str); |
|
124 extern OCTINTERP_API mxArray *mxCreateStructArray (int ndims, int *dims, int num_keys, const char **keys); |
|
125 extern OCTINTERP_API mxArray *mxCreateStructMatrix (int rows, int cols, int num_keys, const char **keys); |
5900
|
126 |
|
127 // Copy constructor. |
6109
|
128 extern OCTINTERP_API mxArray *mxDuplicateArray (const mxArray *v); |
5900
|
129 |
|
130 // Destructor. |
6109
|
131 extern OCTINTERP_API void mxDestroyArray (mxArray *v); |
5900
|
132 |
|
133 // Type Predicates. |
6109
|
134 extern OCTINTERP_API int mxIsCell (const mxArray *ptr); |
|
135 extern OCTINTERP_API int mxIsChar (const mxArray *ptr); |
|
136 extern OCTINTERP_API int mxIsClass (const mxArray *ptr, const char *name); |
|
137 extern OCTINTERP_API int mxIsComplex (const mxArray *ptr); |
|
138 extern OCTINTERP_API int mxIsDouble (const mxArray *ptr); |
|
139 extern OCTINTERP_API int mxIsInt16 (const mxArray *ptr); |
|
140 extern OCTINTERP_API int mxIsInt32 (const mxArray *ptr); |
|
141 extern OCTINTERP_API int mxIsInt64 (const mxArray *ptr); |
|
142 extern OCTINTERP_API int mxIsInt8 (const mxArray *ptr); |
|
143 extern OCTINTERP_API int mxIsLogical (const mxArray *ptr); |
|
144 extern OCTINTERP_API int mxIsNumeric (const mxArray *ptr); |
|
145 extern OCTINTERP_API int mxIsSingle (const mxArray *ptr); |
|
146 extern OCTINTERP_API int mxIsSparse (const mxArray *ptr); |
|
147 extern OCTINTERP_API int mxIsStruct (const mxArray *ptr); |
|
148 extern OCTINTERP_API int mxIsUint16 (const mxArray *ptr); |
|
149 extern OCTINTERP_API int mxIsUint32 (const mxArray *ptr); |
|
150 extern OCTINTERP_API int mxIsUint64 (const mxArray *ptr); |
|
151 extern OCTINTERP_API int mxIsUint8 (const mxArray *ptr); |
5900
|
152 |
|
153 // Odd type+size predicate. |
6109
|
154 extern OCTINTERP_API int mxIsLogicalScalar (const mxArray *ptr); |
5900
|
155 |
|
156 // Odd type+size+value predicate. |
6109
|
157 extern OCTINTERP_API int mxIsLogicalScalarTrue (const mxArray *ptr); |
5900
|
158 |
|
159 // Size predicate. |
6109
|
160 extern OCTINTERP_API int mxIsEmpty (const mxArray *ptr); |
5900
|
161 |
|
162 // Just plain odd thing to ask of a value. |
6109
|
163 extern OCTINTERP_API int mxIsFromGlobalWS (const mxArray *ptr); |
5900
|
164 |
|
165 // Dimension extractors. |
6109
|
166 extern OCTINTERP_API int mxGetM (const mxArray *ptr); |
|
167 extern OCTINTERP_API int mxGetN (const mxArray *ptr); |
|
168 extern OCTINTERP_API int *mxGetDimensions (const mxArray *ptr); |
|
169 extern OCTINTERP_API int mxGetNumberOfDimensions (const mxArray *ptr); |
|
170 extern OCTINTERP_API int mxGetNumberOfElements (const mxArray *ptr); |
5900
|
171 |
|
172 // Dimension setters. |
6109
|
173 extern OCTINTERP_API void mxSetM (mxArray *ptr, int M); |
|
174 extern OCTINTERP_API void mxSetN (mxArray *ptr, int N); |
|
175 extern OCTINTERP_API void mxSetDimensions (mxArray *ptr, int *dims, int ndims); |
5900
|
176 |
|
177 // Data extractors. |
6109
|
178 extern OCTINTERP_API double *mxGetPi (const mxArray *ptr); |
|
179 extern OCTINTERP_API double *mxGetPr (const mxArray *ptr); |
|
180 extern OCTINTERP_API double mxGetScalar (const mxArray *ptr); |
|
181 extern OCTINTERP_API mxChar *mxGetChars (const mxArray *ptr); |
|
182 extern OCTINTERP_API mxLogical *mxGetLogicals (const mxArray *ptr); |
|
183 extern OCTINTERP_API void *mxGetData (const mxArray *ptr); |
|
184 extern OCTINTERP_API void *mxGetImagData (const mxArray *ptr); |
5900
|
185 |
|
186 // Data setters. |
6109
|
187 extern OCTINTERP_API void mxSetPr (mxArray *ptr, double *pr); |
|
188 extern OCTINTERP_API void mxSetPi (mxArray *ptr, double *pi); |
|
189 extern OCTINTERP_API void mxSetData (mxArray *ptr, void *data); |
|
190 extern OCTINTERP_API void mxSetImagData (mxArray *ptr, void *pi); |
5900
|
191 |
|
192 // Classes. |
6109
|
193 extern OCTINTERP_API mxClassID mxGetClassID (const mxArray *ptr); |
|
194 extern OCTINTERP_API const char *mxGetClassName (const mxArray *ptr); |
5900
|
195 |
6109
|
196 extern OCTINTERP_API void mxSetClassName (mxArray *ptr, const char *name); |
5900
|
197 |
|
198 // Cell support. |
6109
|
199 extern OCTINTERP_API mxArray *mxGetCell (const mxArray *ptr, int idx); |
5900
|
200 |
6109
|
201 extern OCTINTERP_API void mxSetCell (mxArray *ptr, int idx, mxArray *val); |
5900
|
202 |
|
203 // Sparse support. |
6109
|
204 extern OCTINTERP_API int *mxGetIr (const mxArray *ptr); |
|
205 extern OCTINTERP_API int *mxGetJc (const mxArray *ptr); |
|
206 extern OCTINTERP_API int mxGetNzmax (const mxArray *ptr); |
5900
|
207 |
6109
|
208 extern OCTINTERP_API void mxSetIr (mxArray *ptr, int *ir); |
|
209 extern OCTINTERP_API void mxSetJc (mxArray *ptr, int *jc); |
|
210 extern OCTINTERP_API void mxSetNzmax (mxArray *ptr, int nzmax); |
5900
|
211 |
|
212 // Structure support. |
6109
|
213 extern OCTINTERP_API int mxAddField (mxArray *ptr, const char *key); |
5900
|
214 |
6109
|
215 extern OCTINTERP_API void mxRemoveField (mxArray *ptr, int key_num); |
5900
|
216 |
6109
|
217 extern OCTINTERP_API mxArray *mxGetField (const mxArray *ptr, int index, const char *key); |
|
218 extern OCTINTERP_API mxArray *mxGetFieldByNumber (const mxArray *ptr, int index, int key_num); |
5900
|
219 |
6109
|
220 extern OCTINTERP_API void mxSetField (mxArray *ptr, int index, const char *key, mxArray *val); |
|
221 extern OCTINTERP_API void mxSetFieldByNumber (mxArray *ptr, int index, int key_num, mxArray *val); |
5900
|
222 |
6109
|
223 extern OCTINTERP_API int mxGetNumberOfFields (const mxArray *ptr); |
5900
|
224 |
6109
|
225 extern OCTINTERP_API const char *mxGetFieldNameByNumber (const mxArray *ptr, int key_num); |
|
226 extern OCTINTERP_API int mxGetFieldNumber (const mxArray *ptr, const char *key); |
5900
|
227 |
6109
|
228 extern OCTINTERP_API int mxGetString (const mxArray *ptr, char *buf, int buflen); |
|
229 extern OCTINTERP_API char *mxArrayToString (const mxArray *ptr); |
5900
|
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 |
6109
|
260 extern OCTINTERP_API int mxCalcSingleSubscript (const mxArray *ptr, int nsubs, int *subs); |
5900
|
261 |
6109
|
262 extern OCTINTERP_API int mxGetElementSize (const mxArray *ptr); |
5900
|
263 |
5864
|
264 #if defined (__cplusplus) |
|
265 } |
|
266 #endif |
|
267 |
|
268 #endif |
|
269 |
|
270 /* |
|
271 ;;; Local Variables: *** |
|
272 ;;; mode: C *** |
|
273 ;;; End: *** |
|
274 */ |