主要内容

mxCreateCharArray (C)

N 维 mxChar 数组

C 语法

#include "matrix.h"
mxArray *mxCreateCharArray(mwSize ndim, const mwSize *dims);

描述

使用 mxCreateCharArray 创建一个 N 维 mxChar 数组,其中每个元素设置为 NULL

MATLAB® 自动删除在 dims 参量中指定的任何尾部单一维度。例如,如果 ndim 等于 5dims 等于 [4 1 7 1 1],则生成的数组的维度为 4×1×7

输入参数

全部展开

维数,指定为 mwSize。如果您指定 0、1 或 2,则 mxCreateCharArray 创建一个二维 mxArray

维度数组,指定为 const mwSize *

维度数组中的每个元素包含该维度中数组的大小。例如,要创建一个 5×7 数组,请将 dims[0] 设置为 5,将 dims[1] 设置为 7。

通常,dims 数组包含 ndim 个元素。

输出参量

全部展开

指向类型为 mxCharmxArray 的指针,指定为 mxArray *

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

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

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

版本历史记录

在 R2006a 之前推出