主要内容

mxCreateNumericArray (C)

一天数字数组

C语法

#include "matrix.h" mxArray *mxCreateNumericArray(mxsize ndim, const mwSize * dimms, mxClassID classid, mxComplexity ComplexFlag);

描述

使用mxCreateNumericArray来创建一个n维的mxArray.数据元素具有指定的数字数据类型classid

mxCreateNumericArray不同于mxCreateDoubleMatrix如下:

  • 中的所有数据元素mxCreateDoubleMatrix是双精度浮点数。中的数据元素mxCreateNumericArray可以是任何数值类型,包括不同的整数精度。

  • mxCreateDoubleMatrix仅创建二维数组。mxCreateNumericArray可以创建两个或多个维度的数组。

MATLAB®属性中指定的任何尾随单例维度会变暗论点。例如,如果ndim=5会变暗=[4 1 7 1 1],则得到的数组具有维数4——- - - - - -1——- - - - - -7

这个表格显示了Cclassid等价于MATLAB类的值。

MATLAB类名

Cclassid价值

int8

mxINT8_CLASS

uint8

mxUINT8_CLASS

int16

mxINT16_CLASS

uint16

mxUINT16_CLASS

int32

mxINT32_CLASS

uint32

mxUINT32_CLASS

int64

mxINT64_CLASS

uint64

mxUINT64_CLASS

mxSINGLE_CLASS

mxDOUBLE_CLASS

调用mxDestroyArray当你用完mxArray.的mxDestroyArray函数重新分配mxArray以及与之相关的实元素和虚元素。

输入参数

全部展开

尺寸的数量,指定为mwSize.如果ndim小于2吗mxCreateNumericArray将维度数设置为2。

尺寸数组,指定为const mwSize *

维度数组中的每个元素都包含该维度中数组的大小。例如,要创建5——- - - - - -7数组、集合dim [0]5,dim [1]7。

通常,会变暗数组中包含了ndim元素。

类标识符,指定为mxClassID枚举。classid确定如何在内存中表示数值数据。例如,mxCreateNumericMatrix商店mxINT16_CLASS值为16位有符号整数。

复杂数组指示器,指定为mxComplexity价值。

的应用程序墨西哥人-R2018a命令时,函数将初始化每个数据元素为0

对于所有其他墨西哥人版本特定的构建选项,该函数设置公关数组中。如果ComplexFlagmxCOMPLEX,则函数设置π数组来0

输出参数

全部展开

指针指向一个mxArray类型的classid,指定为mxArray *

当没有足够的空闲堆空间来创建mxArray

  • 这个函数终止MEX文件并将控制返回到MATLAB提示符。

  • 独立(非mex文件)应用程序-函数返回

例子

参见matlabroot走读生/ / refbook例子

参见matlabroot走读生/ / mx例子

之前介绍过的R2006a