Main Content

mxCreateNumericMatrix (C)

二维数值矩阵

C 语法

#include "matrix.h"
mxArray *mxCreateNumericMatrix(mwSize m, mwSize n, mxClassID classid, mxComplexity ComplexFlag);

说明

使用 mxCreateNumericMatrix 创建二维 mxArrayclassid 指定数组中元素的数值数据类型。

下表显示等效于 MATLAB® 类的 C classid 值。

MATLAB 类名

C classid

int8

mxINT8_CLASS

uint8

mxUINT8_CLASS

int16

mxINT16_CLASS

uint16

mxUINT16_CLASS

int32

mxINT32_CLASS

uint32

mxUINT32_CLASS

int64

mxINT64_CLASS

uint64

mxUINT64_CLASS

single

mxSINGLE_CLASS

double

mxDOUBLE_CLASS

完成使用 mxArray 后,请调用 mxDestroyArraymxDestroyArray 函数将取消分配 mxArray 及其相关联的实部和虚部元素。

输入参数

全部展开

行数,指定为 mwSize

列数,指定为 mwSize

类标识符,指定为 mxClassID 枚举。classid 参数确定数值数据在内存中的表示方式。例如,mxCreateNumericMatrixmxINT16_CLASS 值存储为 16 位有符号整数。

复数数组指示符,指定为 mxComplexity 值。

对于使用 mex -R2018a 命令编译的应用程序,该函数将每个数据元素初始化为 0

对于所有其他 mex 版本特定的编译选项,该函数会设置 pr 数组中的每个元素。如果 ComplexFlagmxCOMPLEX,则该函数会将 pi 数组设置为 0

输出参数

全部展开

指向类型为 classidmxArray 的指针,指定为 mxArray *(如果成功)。

当没有足够的可用堆空间来创建 mxArray 时,该函数不会成功执行。

  • MEX 文件 - 函数将终止 MEX 文件并将控制权返回给 MATLAB 提示符。

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

示例

请参阅 matlabroot/extern/examples/refbook 中的示例:

版本历史记录

在 R2006a 之前推出