ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

C 用の MATLAB エンジン API

MATLAB® と連携して動作する C/C++ プログラムの記述

メモ

C 用のエンジン API 内の関数は、C 行列 APIで定義される MATLAB mxArray データ構造体と連携して動作します。最新の C++ 機能を使用してアプリケーションを作成するには、C++ 用の MATLAB エンジン APIを参照してください。

エンジン アプリケーションとは、独自の C/C++ プログラムから MATLAB を呼び出し、MATLAB を計算エンジンとして使用できるスタンドアロン プログラムです。エンジン アプリケーションをビルドするには、関数 mex を呼び出します。

エンジン アプリケーションを使用するには MATLAB がインストールされている必要があります。マシンに MATLAB Runtime しかない場合は MATLAB エンジンを実行できません。

C エンジン API 関数

EngineMATLAB エンジンの型
engOpenMATLAB エンジン セッションの開始
engOpenSingleUse共有されない単独使用のための MATLAB エンジン セッションの開始
engCloseMATLAB エンジン セッションの終了
engEvalString文字列内の式の評価
engGetVariableMATLAB エンジン ワークスペースからの変数のコピー
engPutVariableMATLAB エンジン ワークスペースへの変数の配置
engGetVisibleMATLAB エンジン セッションの可視性の判断
engSetVisibleMATLAB エンジン セッションの表示または非表示
engOutputBufferMATLAB 出力のバッファーの指定

トピック

エンジン アプリケーションの作成

入門

C または Fortran エンジン アプリケーションのビルドを開始する方法。

C および Fortran 用 MATLAB エンジン API の導入

MATLAB を計算エンジンとして使用して、MATLAB を独自の C プログラムおよび Fortran プログラムから呼び出します。

C アプリケーションからの MATLAB 関数の呼び出し

C エンジン アプリケーション engdemo.c を作成します。

既存の MATLAB セッションへの接続

この例では、エンジン プログラムを既に実行中の MATLAB セッションに接続する方法を説明します。

アプリケーション内のコールバック

ベース ワークスペースのコンテキストで評価されるユーザー インターフェイス コールバックを設計します。

Windows アプリケーションのビルドと実行

Windows システムにおけるランタイム ライブラリ パスの設定

実行時に環境変数 Path を設定して、API 共有ライブラリがある場所をオペレーティング システムに対して指定します。

Windows エンジン アプリケーションのビルド

この例では、C の例 engwindemo.c を使用して Windows® プラットフォーム上でビルド プロセスを検証する方法を説明します。

Windows エンジン アプリケーションの実行

この例では、C のサンプル engwindemo.c を Windows システム プロンプトから実行する方法を説明します。

COM サーバーとしての MATLAB の登録

すべてのセッションで MATLAB を登録して、現在使用している MATLAB バージョンが必ず登録されるようにします。古いバージョンを実行すると、登録されているバージョンが変わることがあります。

Mac アプリケーションのビルドと実行

macOS システムにおけるランタイム ライブラリ パスの設定

環境変数 DYLD_LIBRARY_PATH を設定して、API 共有ライブラリがある場所をオペレーティング システムに対して指定します。

macOS エンジン アプリケーションのビルド

この例では、macOS プラットフォーム上でビルド プロセスを検証する方法を説明します。

macOS エンジン アプリケーションの実行

この例では、C の例 engdemo.cmacOS ターミナル ウィンドウから実行する方法を説明します。

Linux アプリケーションのビルドと実行

Linux システムにおけるランタイム ライブラリ パスの設定

環境変数 LD_LIBRARY_PATH を設定して、API 共有ライブラリがある場所をオペレーティング システムに対して指定します。

Linux エンジン アプリケーションのビルド

この例では、Linux® プラットフォーム上でビルド プロセスを検証する方法を説明します。

Linux エンジン アプリケーションの実行

この例では、C の例 engdemo.c を Linux のシステム プロンプトから実行する方法を説明します。

統合開発環境でのビルド

IDE を使用したエンジン アプリケーションのビルド

エンジン アプリケーションをビルドするための統合開発環境の設定に関するヒント。

トラブルシューティング

MATLAB エンジンを開始できない

MATLAB エンジンが実行されない場合の対処方法。

C エンジンによって呼び出される MATLAB 関数のデバッグ

エンジン アプリケーションで使用される MATLAB 関数の検証方法。

ユーザー入力のサポートなし

ユーザーとの対話を行う一部の MATLAB 関数は、エンジン アプリケーションではサポートされていません。

マルチスレッド アプリケーション

MATLAB ライブラリは、スレッドセーフではありません。