mxSetComplexInt8s (C)

Set complex data elements in mxINT8_CLASS array

C Syntax

#include "matrix.h"
int mxSetComplexInt8s(mxArray *pa, mxComplexInt8 *dt);


Use mxSetComplexInt8s to set mxComplexInt8 data in the specified array.



Input Arguments

expand all

Pointer to an mxINT8_CLASS array.

Pointer to the first mxComplexInt8 element of the data array. dt must be allocated by the functions mxCalloc or mxMalloc.

Output Arguments

expand all


If pa is NULL, then the function returns 0.

The function is unsuccessful when mxArray is not an unshared mxINT8_CLASS array, or if the data is not allocated with mxCalloc. If the function is unsuccessful, then:




Refer to the arrayFillSetComplexPr.c example in the matlabroot/extern/examples/refbook folder which copies existing complex numeric data into an mxArray. The data in the example is defined as mxComplexDouble. You can use this example as a pattern for any complex C numeric type. To modify this example for complex int8 data:

  • Declare the data variables as mxComplexInt8

  • Call mxCreateNumericMatrix with the numeric type mxINT8_CLASS

  • Replace mxSetDoubles with mxSetComplexInt8s to put the C array into an mxArray

API Version


mex -R2018a myMexFile.c

Introduced in R2018a