build

クラス: clibgen.LibraryDefinition
名前空間: clibgen

ライブラリインターフェイスの作成

構文

build(libDef)

説明

build(libDef) は、関数 clibgen.generateLibraryDefinition で作成したライブラリ定義ファイルからインターフェイスを検証し、作成します。詳細については、C++ ライブラリに対する MATLAB インターフェイスをパブリッシュする手順を参照してください。

成功した場合、このメソッドによりコマンドウィンドウに出力が表示されます。この出力には、生成されたインターフェイスファイルと、検証の失敗により破棄された関数についての情報が含まれます。この関数は、clibgen.generateLibraryDefinition の名前と値の引数 Verbose が true の場合、ビルドログも表示します。

例

すべて展開する

`sample` インターフェイスの作成

次のステートメントを含むヘッダーファイル 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')

入力引数

すべて展開する

`libDef` — ライブラリ定義
`clibgen.LibraryDefinition`

ライブラリ定義。clibgen.LibraryDefinition オブジェクトとして指定します。libDef は clibgen.generateLibraryDefinition が作成するファイルです。

例: build(defineschool)

ヒント

トラブルシューティングの詳細については、Troubleshooting C++ Library Definition Issuesを参照してください。

代替機能

関数 `clibgen.buildInterface`

MATLAB^® がライブラリのクラスコンストラクター、メソッド、データメンバー、および関数をすべて自動的に定義することが分かっている場合、もしくはインターフェイスに未定義の構成が不要な場合、clibgen.generateLibraryDefinition と build の代わりに関数 clibgen.buildInterface を使用します。

詳細については、C++ ライブラリインターフェイスのビルドと内容の確認を参照してください。