mxGetComplexInt8s (C)

Complex data elements in mxINT8_CLASS array

C Syntax

#include "matrix.h"
mxComplexInt8 *mxGetComplexInt8s(const mxArray *pa);

Input Arguments

pa — MATLAB array

const mxArray *

Pointer to an mxINT8_CLASS array.

Output Arguments

dt — Data array

mxComplexInt8 *

Pointer to the first mxComplexInt8 element of the data. If pa is NULL, then the function returns NULL.

If mxArray is not an mxINT8_CLASS array:

• MEX file — Function terminates the MEX file and returns control to the MATLAB^® prompt.

• Standalone (non-MEX file) application — Function returns NULL. A NULL return value indicates that pa is either empty or not an mxINT8_CLASS array.

Examples

To open an example, type:

edit([fullfile(matlabroot,"extern","examples","mex","filename")]);

where filename is:

• explore.c

API Version

This function is available in the interleaved complex API. To build myMexFile.c using this function, type:

mex -R2018a myMexFile.c

Version History

Introduced in R2018a