Main Content

clibArray

为 C++ 库函数创建 MATLAB clib 数组

自 R2020a 起

说明

示例

cArray = clibArray(elementTypeName,dimensions) 创建一个 clib 数组,它是一个表示 elementTypeName 类型 C++ 对象的 MATLAB® 对象,其 C++ 维度指定为 [x1,...,xN]。如果该 C++ 对象是原始类型,则 cArray 包含零值。如果该 C++ 对象是类类型,则 MATLAB 使用默认构造函数初始化 cArray

仅当支持的 C++ 构造(函数参量、函数返回和数据成员)使用对应的 C++ 原生数组或 std::vector 时,才能定义 MATLAB clib 数组。

或者,如果元素类型是基础类型、具有默认构造函数的用户定义类或标准字符串类型,则调用 clib.array 构造函数。例如,对于 libname 中定义的 elementTypeName

cArray = clib.array.libname.elementTypeName(dimensions)

cArray 的内存归 MATLAB 所有。要释放该内存,请调用 clibRelease

要将 MATLAB 数组转换为 C++ 数组,请调用 clibConvertArray

示例

全部折叠

假设您有一个库 libname,其类为 myclass

创建一个包含五个 myclass 对象的空数组。

myclassArray = clibArray('clib.libname.myclass',5);
class(myclassArray)
ans = 
    'clib.array.libname.myclass' 

输入参数

全部折叠

C++ 类型,指定为字符串或字符向量。有关详细信息,请参阅C++ to MATLAB Data Type Mapping。支持的类型有:

MATLAB 将基本 C++ 类型的名称转换为大驼峰式命名法。例如,C++ 类型 signed intelementTypeNameSignedInt

该类型是完全限定的 C++ 类型名称。例如,如果库 libname 定义了类 myclass,则 elementTypeNameclib.libname.myclass

示例: clib.libname.Double

数据类型: char | string

数组的每个维度中的元素数量,指定为整数 [x1,...,xN]

示例: [2,3]

版本历史记录

在 R2020a 中推出