mwArray
API を使用して C++ アプリケーションへのデプロイ (C++03)
mwArray
関数を C++ アプリケーションに統合するこの方法では、デプロイする MATLAB 関数から C++ 共有ライブラリおよびヘッダー ファイルを作成します。C++ アプリケーションとデプロイされた MATLAB 関数とのインターフェイスとして C++ 用のレガシ MATLAB Compiler SDK™ API を使用します。mwArray
API を使用して、C++ アプリケーションとデプロイされた MATLAB 関数間のデータ交換を処理します。デプロイされた MATLAB 関数を C++ コード内でメンバー関数として使用可能にするには、プリプロセッサ命令を使用して C++ アプリケーションに生成済みのヘッダー ファイルを組み込む必要があります。デプロイされた MATLAB 関数で使用される MATLAB Runtime インスタンスのライフサイクルを明示的に管理する必要があります。Runtime インスタンスは、C++ アプリケーションでインプロセスでのみ実行できます。デプロイされた MATLAB 関数は同期的にのみ実行できます。
C++ mwArray
API は C++03 の機能のみをサポートします。mwArray
API を使用する C++ 共有ライブラリのインターフェイスは、C スタイルの関数を使用して MATLAB Runtime の初期化、パッケージ化された MATLAB 関数の MATLAB Runtime への読み込み、および C++ ドライバー コードと MATLAB Runtime の間で渡されるデータの管理を行います。これらの関数は C/C++ API で説明されています。C++ mwArray
API の下にリストされている関数は mwArray
API に固有であり、他の API 用に作成された共有ライブラリには使用できません。
関数
compiler.build.cppSharedLibrary | C++ 共有ライブラリの作成 (R2021a 以降) |
compiler.build.CppSharedLibraryOptions | C++ 共有ライブラリのビルド オプション (R2021a 以降) |
mbuild | MATLAB の生成された共有ライブラリに対してソース ファイルをコンパイルおよびリンクする |
C/C++ API
mclmcrInitialize | MATLAB Runtime プロキシ ライブラリの初期化 |
mclInitializeApplication | 現在のプロセスで作成されたすべての MATLAB Runtime インスタンスによって共有されるアプリケーション状態の設定 |
mclTerminateApplication | MATLAB Runtime 内部アプリケーション状態を閉じる |
<library>Initialize[WithHandlers] | に関連付けられている MATLAB Runtime インスタンスを初期化 |
<library>Terminate | に関連付けられている MATLAB Runtime インスタンスによって割り当てられているリソースをすべて解放する |
mclRunMain | すべてのプラットフォームで同一のラッパー コードを作成するためのメカニズム |
mclIsMCRInitialized | Determine if MATLAB Runtime has been properly initialized |
mclWaitForFiguresToDie | Enable deployed applications to process graphics events so that figure windows remain displayed |
mclGetLastErrorMessage | Last error message from unsuccessful library initialization or MATLAB function call |
mclGetLogFileName | MATLAB Runtime で使用しているログ ファイルの名前を取得 |
mclIsJVMEnabled | Determine if MATLAB Runtime was started with instance of Java Virtual Machine (JVM) |
mclIsNoDisplaySet | -nodisplay モードが有効かどうかを判定 |
C++ mwArray API
mwArray | Class used to pass input/output arguments to C++ functions generated by MATLAB Compiler SDK |
mwException | Exception type used by the mwArray API
and the C++ interface functions |
mwString | String class used by the mwArray API
to pass string data as output from certain methods |
トピック
要件
- MATLAB Compiler SDK の C++ ターゲットの要件
MATLAB Compiler SDK を使用して C++ アプリケーションに MATLAB 関数をデプロイするためのソフトウェア要件を確認する。 - C++ 開発環境の設定
デプロイされた MATLAB 関数を統合する C++ アプリケーションを開発するための開発環境を設定する。
C++ mwArray
API 共有ライブラリの作成
- C++ mwArray API 共有ライブラリの生成と C++ アプリケーションのビルド
MATLAB コードから C++ mwArray API 共有ライブラリを作成し、サンプル C++ ドライバー コードを使って実装する。
C++ 共有ライブラリと C++ アプリケーションの統合
- Call MATLAB Compiler SDK API Functions from C/C++
Use MATLAB Compiler SDK shared library functions in C and C++ code. - Integrate C++ Shared Libraries with mwArray
Write C++ code to reference shared libraries that use themwArray
API. - Create Sample Code to Call Exported Function
Generate sample code in C++, .NET, Java®, or Python® by including sample files during packaging. - mbuild オプション ファイルの構成
mbuild
オプション ファイルを構成する方法。 - Use Multiple Shared Libraries in Single Application
Use multiple generated shared libraries in a single C/C++ application.
保守
- メモリの管理およびクリーンアップ
メモリ管理の推奨について説明する。 - mclmcrrt プロキシ層について
MATLAB Compiler™ および MATLAB Compiler SDK で生成されるアプリケーションやソフトウェアのコンポーネントは、いずれも 1 つの MATLAB ライブラリmclmcrrt
のみに対してリンクする必要があります。 - Compilation Failures
List of possible failures during compilation. - Testing Failures
List of possible failures during testing. - Deployment Failures
List of possible failures during deployment.