Main Content

mxCreateNumericMatrix (C)

二维数值矩阵

全页展开

C 语法

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

描述

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

下表显示等效于 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 后，请调用 mxDestroyArray。mxDestroyArray 函数将取消分配 mxArray 及其相关联的实部和虚部元素。

输入参数

全部展开

行数，指定为 mwSize。

列数，指定为 mwSize。

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

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

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

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

输出参量

全部展开

指向类型为 classid 的 mxArray 的指针，指定为 mxArray *（如果成功）。

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

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

  • 独立（非 MEX 文件）应用程序 - 函数将返回 NULL。

示例

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

版本历史记录

在 R2006a 之前推出

另请参阅

| | | |