C++ ライブラリに対する MATLAB インターフェイスの作成

C++ ライブラリに対する MATLAB^® インターフェイスを作成するために、MATLABclibgen パッケージを使用する

C++ ライブラリに対し MATLAB インターフェイスを作成 ("パブリッシュ") するには、C++ ライブラリに対する MATLAB インターフェイスをパブリッシュする手順を参照してください。

MATLAB からのライブラリ内にある関数の呼び出しの詳細については、C++ ライブラリに対するプリビルド MATLAB インターフェイスの使用を参照してください。

関数

`clibgen.generateLibraryDefinition`	C++ ライブラリの定義ファイルを作成
`clibgen.buildInterface`	定義ファイルなしで C++ ライブラリへのインターフェイスを作成

パッケージ

clibgen Package MATLAB からの C++ ライブラリ機能の呼び出しをサポートするためのパッケージとクラスの概要

トピック

インターフェイスをパブリッシュする方法

What Types of Files Define Your Library?
How to set the arguments to the clibgen.generateLibraryDefinition function.
C++ ライブラリに対する MATLAB インターフェイスをパブリッシュする手順
インターフェイスを C++ ライブラリにパブリッシュする概要。
C++ ライブラリに対するインターフェイスをビルドするための要件
MATLAB から外部のコンパイル済み C++ ライブラリの関数を呼び出すための要件。
Distribute MATLAB Interface to C++ Library
How to share your MATLAB interface with MATLAB users.

ヘッダーファイルおよびコンパイル済みライブラリファイルで定義されたライブラリ

Windows でのヘッダーファイルおよびコンパイル済みライブラリファイル

この例では、C++ ライブラリに対する MATLAB インターフェイスをインポートライブラリファイル matrixOperations.lib から作成します。
- ステップ 1: Windows でのインターフェイスの生成
- ステップ 2: 不足している構成要素の定義
- ステップ 3: インターフェイスのビルド
- ステップ 4: Windows でのライブラリ関数の呼び出し
Linux でのヘッダーファイルおよびコンパイル済みライブラリファイル

この例では、共有オブジェクトファイル libmwmatrixOperations.so を含む C++ ライブラリに対する MATLAB インターフェイスを作成します。
- ステップ 1: Generate Interface on Linux
- ステップ 2: 不足している構成要素の定義
- ステップ 3: インターフェイスのビルド
- ステップ 4: Linux でのライブラリ関数の呼び出し
macOS でのヘッダーファイルおよびコンパイル済みライブラリファイル

この例では、動的共有ライブラリファイル libmwmatrixOperations.dylib を使って、C++ ライブラリに対する MATLAB インターフェイスを作成します。
- ステップ 1: macOS でのインターフェイスの生成
- ステップ 2: 不足している構成要素の定義
- ステップ 3: インターフェイスのビルド
- ステップ 4: macOS でのライブラリ関数の呼び出し

ヘッダーファイル/CPP ソースファイルで定義されたライブラリ

ヘッダーと CPP のソースファイル

この例では、ソースファイル matrixOperations.hpp および matrixOperations.cpp で定義された C++ ライブラリに対する MATLAB インターフェイスを作成します。
- ステップ 1: インターフェイスの生成
- ステップ 2: 不足している構成要素の定義
- ステップ 3: matrixoperations ライブラリに対するインターフェイスのビルド
- ステップ 4: matrixoperations ライブラリ関数の呼び出し
ヘッダー専用の HPP ファイル

この例では、ヘッダーファイル school.hpp で定義された C++ ライブラリに対する MATLAB インターフェイスを作成します。
- ステップ 1: school ライブラリに対するインターフェイスの生成
- ステップ 2: Define Missing Constructs in Interface to school Library
- ステップ 3: school ライブラリに対するインターフェイスのビルド
- ステップ 4: school ライブラリ関数の呼び出し

定義とカスタマイズ

C++ ライブラリに対する MATLAB インターフェイスの定義

MATLAB ライブラリ定義ファイルを生成し、編集してインターフェイスのカスタマイズと定義を行う。
C++ ライブラリに対する MATLAB インターフェイスのヘルプテキストのパブリッシュ

C++ ライブラリに対する MATLAB インターフェイスのエンドユーザーにドキュメンテーションを提供。
- ライブラリのヘルプの変更
C++ から MATLAB へのデータ型のマッピング
C/C++ 型への MATLAB データ型の対応。
MATLAB での C++ オブジェクトの有効期間の管理
コンパイル済みの C++ ライブラリに対する MATLAB インターフェイスで作成された C++ オブジェクトのメモリを管理するための MATLAB ルール。
Initialize Pointer Members of C++ Structures for MATLAB Interface to Library
Verify that C++ class constructors initialize pointer members.

トラブルシューティング

C++ ライブラリインターフェイスのビルドと内容の確認

ライブラリの機能が不足している場合、ライブラリにサポートされていない言語機能またはデータ型が含まれている可能性があります。

C/C++ サポートに関する制限

MATLAB でサポートされない C/C++ ライブラリ機能。

C++ の制限を回避する例

Troubleshooting C++ Library Definition Issues

Information for resolving error when publishing a MATLAB interface to a C++ library.