Main Content

mxCreateStructMatrix (Fortran)

二维结构体数组

Fortran 语法

#include "fintrf.h"
mwPointer mxCreateStructMatrix(m, n, nfields, fieldnames)
mwSize m, n
integer*4 nfields
character*(*) fieldnames(nfields)

描述

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

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

输入参数

全部展开

行数,指定为 mwSize

列数,指定为 mwSize

每个元素中的字段数,指定为 integer*4

一个或多个字段名称,指定为 character*(*)

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

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

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

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

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

版本历史记录

在 R2006a 之前推出