This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

mxSetComplexUint32s (C)

Set complex data elements in mxUINT32_CLASS array

C Syntax

#include "matrix.h"
int mxSetComplexUint32s(mxArray *pa, mxComplexUint32 *dt);

Description

Use mxSetComplexUint32s to set mxUint32 data of the specified mxArray.

All mxCreate* functions allocate heap space to hold data. Therefore, you do not ordinarily use this function to initialize the elements of an array. Rather, call this function to replace the existing values with new values.

This function does not free memory allocated for existing data. To free existing memory, call mxFree on the pointer returned by mxGetComplexUint32s.

Input Arguments

expand all

Pointer to an mxUINT32_CLASS array.

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

Output Arguments

expand all

Function status, returned as int. If successful, then the function returns 1.

If pa is NULL, then the function returns 0.

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

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

  • Standalone (non-MEX file) application — Function returns 0.

Examples

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 uint32 data:

  • Declare the data variables as mxComplexUint32

  • Call mxCreateNumericMatrix with the numeric type mxUINT32_CLASS

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

API Version

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

mex -R2018a myMexFile.c

Introduced in R2018a