Main Content

build

类: clibgen.LibraryDefinition
命名空间: clibgen

构建库接口

语法

build(libDef)

说明

build(libDef) 验证并基于用 clibgen.generateLibraryDefinition 函数创建的库定义文件编译接口。有关详细信息,请参阅发布 C++ 库 MATLAB 接口的步骤

如果成功,该方法会将输出打印到命令行窗口。输出包含有关生成的接口文件以及由于验证失败而丢弃的任何函数的信息。如果 clibgen.generateLibraryDefinition 中的 Verbose 名称-值参量为 true,该函数还会显示编译日志。

示例

全部展开

使用以下语句创建头文件 sample.hpp

void func1(){}; 
void func2 (int){}; 
double func3(int){}; 

生成定义文件。

clibgen.generateLibraryDefinition("sample.hpp",OverwriteExistingDefinitionFiles=true)
C++ compiler set to 'MinGW64 Compiler (C++)'.
Definition file definesample.m contains definitions for 3 constructs supported by MATLAB.
- 3 construct(s) are fully defined.
To build the interface, call build(definesample).

定义文件完全定义接口。

查看内容。

summary(definesample)
MATLAB Interface to sample Library

Functions
clib.sample.func1()
clib.sample.func2(int32)
double clib.sample.func3(int32)

编译接口。

build(definesample)
Building interface file 'sampleInterface.dll' for clib interface 'sample'.
Interface file 'sampleInterface.dll' built in folder 'C:\Documents\MATLAB\sample'.

To use the library, add the interface file folder to the MATLAB path.
addpath('C:\Documents\MATLAB\sample')

输入参数

全部展开

库定义,指定为 clibgen.LibraryDefinition 对象。libDef 是由 clibgen.generateLibraryDefinition 创建的文件。

示例: build(defineschool)

提示

替代功能

clibgen.buildInterface 函数

如果您知道 MATLAB® 会自动定义库的所有类构造函数、方法、数据成员和函数,或如果您的接口不需要未定义的构造,请使用 clibgen.buildInterface 函数而不是 clibgen.generateLibraryDefinitionbuild

有关详细信息,请参阅 Build C++ Library Interface and Review Contents

版本历史记录

在 R2019a 中推出