/usr/include/octave-4.2.2/octave/mexproto.h is in liboctave-dev 4.2.2-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 | /*
Copyright (C) 2006-2017 Paul Kienzle
This file is part of Octave.
Octave is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
Octave is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License
along with Octave; see the file COPYING. If not, see
<http://www.gnu.org/licenses/>.
*/
/*
This code was originally distributed as part of Octave Forge under
the following terms:
Author: Paul Kienzle
I grant this code to the public domain.
2001-03-22
THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
*/
/* mex.h is for use in C-programs only; do NOT include it in mex.cc */
#if ! defined (octave_mexproto_h)
#define octave_mexproto_h 1
#include "octave-config.h"
#if defined (__cplusplus)
# include <cstdlib>
extern "C" {
#else
# include <stdlib.h>
# include <stdbool.h>
#endif
/* The definition of OCTINTERP_API is normally provided by Octave's
config.h file. This is provided for the case of mex.h included by
user programs that don't use Octave's config.h. */
#if ! defined (OCTINTERP_API)
# if defined (_MSC_VER)
# define OCTINTERP_API __declspec(dllimport)
# else
/* All other compilers, at least for now. */
# define OCTINTERP_API
# endif
#endif
#define MXARRAY_TYPEDEFS_ONLY
#include "mxarray.h"
#undef MXARRAY_TYPEDEFS_ONLY
/* Interface to the interpreter. */
extern OCTINTERP_API const char *mexFunctionName (void);
extern OCTINTERP_API int mexCallMATLAB (int nargout, mxArray *argout[],
int nargin, mxArray *argin[],
const char *fname);
extern OCTINTERP_API mxArray * mexCallMATLABWithTrap (int nargout,
mxArray *argout[],
int nargin,
mxArray *argin[],
const char *fname);
extern OCTINTERP_API int mexEvalString (const char *s);
extern OCTINTERP_API mxArray * mexEvalStringWithTrap (const char *s);
extern OCTINTERP_API void mexSetTrapFlag (int flag);
extern OCTINTERP_API void mexErrMsgTxt (const char *s);
extern OCTINTERP_API void mexErrMsgIdAndTxt (const char *id, const char *s,
...);
extern OCTINTERP_API void mexWarnMsgTxt (const char *s);
extern OCTINTERP_API void mexWarnMsgIdAndTxt (const char *id, const char *s,
...);
extern OCTINTERP_API int mexPrintf (const char *fmt, ...);
extern OCTINTERP_API mxArray *mexGetVariable (const char *space,
const char *name);
extern OCTINTERP_API const mxArray *mexGetVariablePtr (const char *space,
const char *name);
extern OCTINTERP_API int mexPutVariable (const char *space, const char *name,
const mxArray *ptr);
extern OCTINTERP_API const mxArray *mexGet (double handle,
const char *property);
extern OCTINTERP_API int mexSet (double handle, const char *property,
mxArray *val);
extern OCTINTERP_API void mexMakeArrayPersistent (mxArray *ptr);
extern OCTINTERP_API void mexMakeMemoryPersistent (void *ptr);
extern OCTINTERP_API void mexLock (void);
extern OCTINTERP_API void mexUnlock (void);
extern OCTINTERP_API int mexIsGlobal (const mxArray *ptr);
extern OCTINTERP_API int mexIsLocked (void);
extern OCTINTERP_API int mexAtExit (void (*f) (void));
/* Floating point predicates. */
extern OCTINTERP_API bool mxIsFinite (double v);
extern OCTINTERP_API bool mxIsInf (double v);
extern OCTINTERP_API bool mxIsNaN (double v);
/* Floating point values. */
extern OCTINTERP_API double mxGetEps (void);
extern OCTINTERP_API double mxGetInf (void);
extern OCTINTERP_API double mxGetNaN (void);
/* Memory management. */
extern OCTINTERP_API void *mxCalloc (size_t n, size_t size);
extern OCTINTERP_API void *mxMalloc (size_t n);
extern OCTINTERP_API void *mxRealloc (void *ptr, size_t size);
extern OCTINTERP_API void mxFree (void *ptr);
/* Constructors. */
extern OCTINTERP_API mxArray *mxCreateCellArray (mwSize ndims,
const mwSize *dims);
extern OCTINTERP_API mxArray *mxCreateCellMatrix (mwSize m, mwSize n);
extern OCTINTERP_API mxArray *mxCreateCharArray (mwSize ndims,
const mwSize *dims);
extern OCTINTERP_API mxArray *mxCreateCharMatrixFromStrings (mwSize m,
const char **str);
extern OCTINTERP_API mxArray *mxCreateDoubleMatrix (mwSize nr, mwSize nc,
mxComplexity flag);
extern OCTINTERP_API mxArray *mxCreateDoubleScalar (double val);
extern OCTINTERP_API mxArray *mxCreateLogicalArray (mwSize ndims,
const mwSize *dims);
extern OCTINTERP_API mxArray *mxCreateLogicalMatrix (mwSize m, mwSize n);
extern OCTINTERP_API mxArray *mxCreateLogicalScalar (mxLogical val);
extern OCTINTERP_API mxArray *mxCreateNumericArray (mwSize ndims,
const mwSize *dims,
mxClassID class_id,
mxComplexity flag);
extern OCTINTERP_API mxArray *mxCreateNumericMatrix (mwSize m, mwSize n,
mxClassID class_id,
mxComplexity flag);
extern OCTINTERP_API mxArray *mxCreateUninitNumericArray (mwSize ndims,
const mwSize *dims,
mxClassID class_id,
mxComplexity flag);
extern OCTINTERP_API mxArray *mxCreateUninitNumericMatrix (mwSize m, mwSize n,
mxClassID class_id,
mxComplexity flag);
extern OCTINTERP_API mxArray *mxCreateSparse (mwSize m, mwSize n, mwSize nzmax,
mxComplexity flag);
extern OCTINTERP_API mxArray *mxCreateSparseLogicalMatrix (mwSize m, mwSize n,
mwSize nzmax);
extern OCTINTERP_API mxArray *mxCreateString (const char *str);
extern OCTINTERP_API mxArray *mxCreateStructArray (mwSize ndims,
const mwSize *dims,
int num_keys,
const char **keys);
extern OCTINTERP_API mxArray *mxCreateStructMatrix (mwSize rows, mwSize cols,
int num_keys,
const char **keys);
/* Copy constructor. */
extern OCTINTERP_API mxArray *mxDuplicateArray (const mxArray *v);
/* Destructor. */
extern OCTINTERP_API void mxDestroyArray (mxArray *v);
/* Type Predicates. */
extern OCTINTERP_API bool mxIsCell (const mxArray *ptr);
extern OCTINTERP_API bool mxIsChar (const mxArray *ptr);
extern OCTINTERP_API bool mxIsClass (const mxArray *ptr, const char *name);
extern OCTINTERP_API bool mxIsComplex (const mxArray *ptr);
extern OCTINTERP_API bool mxIsDouble (const mxArray *ptr);
/* Matlab seems to have deprecated IsFunctionHandle, but it seems useful */
extern OCTINTERP_API bool mxIsFunctionHandle (const mxArray *ptr);
extern OCTINTERP_API bool mxIsInt16 (const mxArray *ptr);
extern OCTINTERP_API bool mxIsInt32 (const mxArray *ptr);
extern OCTINTERP_API bool mxIsInt64 (const mxArray *ptr);
extern OCTINTERP_API bool mxIsInt8 (const mxArray *ptr);
extern OCTINTERP_API bool mxIsLogical (const mxArray *ptr);
extern OCTINTERP_API bool mxIsNumeric (const mxArray *ptr);
extern OCTINTERP_API bool mxIsSingle (const mxArray *ptr);
extern OCTINTERP_API bool mxIsSparse (const mxArray *ptr);
extern OCTINTERP_API bool mxIsStruct (const mxArray *ptr);
extern OCTINTERP_API bool mxIsUint16 (const mxArray *ptr);
extern OCTINTERP_API bool mxIsUint32 (const mxArray *ptr);
extern OCTINTERP_API bool mxIsUint64 (const mxArray *ptr);
extern OCTINTERP_API bool mxIsUint8 (const mxArray *ptr);
/* Odd type+size predicate. */
extern OCTINTERP_API bool mxIsLogicalScalar (const mxArray *ptr);
/* Odd type+size+value predicate. */
extern OCTINTERP_API bool mxIsLogicalScalarTrue (const mxArray *ptr);
/* Size predicates. */
extern OCTINTERP_API bool mxIsEmpty (const mxArray *ptr);
extern OCTINTERP_API bool mxIsScalar (const mxArray *ptr);
/* Just plain odd thing to ask of a value. */
extern OCTINTERP_API bool mxIsFromGlobalWS (const mxArray *ptr);
/* Dimension extractors. */
extern OCTINTERP_API size_t mxGetM (const mxArray *ptr);
extern OCTINTERP_API size_t mxGetN (const mxArray *ptr);
extern OCTINTERP_API const mwSize *mxGetDimensions (const mxArray *ptr);
extern OCTINTERP_API mwSize mxGetNumberOfDimensions (const mxArray *ptr);
extern OCTINTERP_API size_t mxGetNumberOfElements (const mxArray *ptr);
/* Dimension setters. */
extern OCTINTERP_API void mxSetM (mxArray *ptr, mwSize M);
extern OCTINTERP_API void mxSetN (mxArray *ptr, mwSize N);
extern OCTINTERP_API int mxSetDimensions (mxArray *ptr, const mwSize *dims,
mwSize ndims);
/* Data extractors. */
extern OCTINTERP_API double *mxGetPi (const mxArray *ptr);
extern OCTINTERP_API double *mxGetPr (const mxArray *ptr);
extern OCTINTERP_API double mxGetScalar (const mxArray *ptr);
extern OCTINTERP_API mxChar *mxGetChars (const mxArray *ptr);
extern OCTINTERP_API mxLogical *mxGetLogicals (const mxArray *ptr);
extern OCTINTERP_API void *mxGetData (const mxArray *ptr);
extern OCTINTERP_API void *mxGetImagData (const mxArray *ptr);
/* Data setters. */
extern OCTINTERP_API void mxSetPr (mxArray *ptr, double *pr);
extern OCTINTERP_API void mxSetPi (mxArray *ptr, double *pi);
extern OCTINTERP_API void mxSetData (mxArray *ptr, void *data);
extern OCTINTERP_API void mxSetImagData (mxArray *ptr, void *pi);
/* Classes. */
extern OCTINTERP_API mxClassID mxGetClassID (const mxArray *ptr);
extern OCTINTERP_API const char *mxGetClassName (const mxArray *ptr);
extern OCTINTERP_API void mxSetClassName (mxArray *ptr, const char *name);
/* Cell support. */
extern OCTINTERP_API mxArray *mxGetCell (const mxArray *ptr, mwIndex idx);
extern OCTINTERP_API void mxSetCell (mxArray *ptr, mwIndex idx, mxArray *val);
/* Sparse support. */
extern OCTINTERP_API mwIndex *mxGetIr (const mxArray *ptr);
extern OCTINTERP_API mwIndex *mxGetJc (const mxArray *ptr);
extern OCTINTERP_API mwSize mxGetNzmax (const mxArray *ptr);
extern OCTINTERP_API void mxSetIr (mxArray *ptr, mwIndex *ir);
extern OCTINTERP_API void mxSetJc (mxArray *ptr, mwIndex *jc);
extern OCTINTERP_API void mxSetNzmax (mxArray *ptr, mwSize nzmax);
/* Structure support. */
extern OCTINTERP_API int mxAddField (mxArray *ptr, const char *key);
extern OCTINTERP_API void mxRemoveField (mxArray *ptr, int key_num);
extern OCTINTERP_API mxArray *mxGetField (const mxArray *ptr, mwIndex index,
const char *key);
extern OCTINTERP_API mxArray *mxGetFieldByNumber (const mxArray *ptr,
mwIndex index, int key_num);
extern OCTINTERP_API void mxSetField (mxArray *ptr, mwIndex index,
const char *key, mxArray *val);
extern OCTINTERP_API void mxSetFieldByNumber (mxArray *ptr, mwIndex index,
int key_num, mxArray *val);
extern OCTINTERP_API int mxGetNumberOfFields (const mxArray *ptr);
extern OCTINTERP_API const char *mxGetFieldNameByNumber (const mxArray *ptr,
int key_num);
extern OCTINTERP_API int mxGetFieldNumber (const mxArray *ptr, const char *key);
extern OCTINTERP_API int mxGetString (const mxArray *ptr, char *buf,
mwSize buflen);
extern OCTINTERP_API char *mxArrayToString (const mxArray *ptr);
/* Miscellaneous. */
extern OCTINTERP_API mwIndex mxCalcSingleSubscript (const mxArray *ptr,
mwSize nsubs,
mwIndex *subs);
extern OCTINTERP_API size_t mxGetElementSize (const mxArray *ptr);
#if defined (MEX_DEBUG)
# define mxAssert(expr, msg) \
do \
{ \
if (! (expr)) \
{ \
if (msg != NULL && msg[0] != '\0') \
mexErrMsgIdAndTxt ("Octave:MEX", \
"Assertion failed: %s, at line %d of file \"%s\".\n%s\n", \
#expr, __LINE__, __FILE__, msg); \
else \
mexErrMsgIdAndTxt ("Octave:MEX", \
"Assertion failed: %s, at line %d of file \"%s\".\n", \
#expr, __LINE__, __FILE__); \
} \
} \
while (0)
# define mxAssertS(expr, msg) \
do \
{ \
if (! (expr)) \
{ \
if (msg != NULL && msg[0] != '\0') \
mexErrMsgIdAndTxt ("Octave:MEX", \
"Assertion failed at line %d of file \"%s\".\n%s\n", \
__LINE__, __FILE__, msg); \
else \
mexErrMsgIdAndTxt ("Octave:MEX", \
"Assertion failed at line %d of file \"%s\".\n", \
__LINE__, __FILE__); \
} \
} \
while (0)
#else
# define mxAssert(expr, msg)
# define mxAssertS(expr, msg)
#endif
#if defined (__cplusplus)
}
#endif
#endif
|