Main Content

mxCreateStructMatrix (C)

二维结构体数组

C 语法

#include "matrix.h"
mxArray *mxCreateStructMatrix(mwSize m, mwSize n, int nfields, const char **fieldnames);

描述

调用 mxCreateStructMatrix 来创建一个未填充的二维结构体 mxArray。有关该结构体的信息,请参阅 mxCreateStructArray

当您完成使用 mxArray 来取消分配 mxArray 及其关联元素时,请调用 mxDestroyArray

输入参数

全部展开

行数,指定为 mwSize

列数,指定为 mwSize

每个元素中的字段数,指定为 int

一个或多个字段名称,指定为 const char **

字段名称必须为有效的 MATLAB® 标识符,这意味着它们不能为 NULL 或为空。字段名称区分大小写。要确定字段名称的最大长度,请使用 namelengthmax 函数。

输出参量

全部展开

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

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

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

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

示例

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

版本历史记录

在 R2006a 之前推出