Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

MATLAB (MEX ファイル) から呼び出せる C 関数の記述

MATLAB® R2017b 以前から呼び出し可能な C 関数を作成し、mxArray を使用して MATLAB 変数にアクセスし、MATLAB に返す配列を作成する

MATLAB コマンド ラインからユーザー独自の C プログラムを組み込み関数のように呼び出すことができます。これらのプログラムは MEX 関数と呼ばれ、関数名は MEX ファイル名です。MEX 関数はすべてのアプリケーションに適しているわけではありません。MATLAB は、コンパイル言語での時間のかかる低水準プログラミングの排除を専門とする、生産性の高い環境です。通常、プログラミングは MATLAB で行ってください。アプリケーションで必要な場合を除き、MEX 関数は使用しないでください。

MEX 関数を作成するには、MATLAB API を使用してプログラムを作成します。これらのライブラリの関数は、MEX 関数とワークスペース間でデータの転送をしやすくします。MATLAB API を選択するには、以下を検討してください。

  • C++ 用の MATLAB データ APIで定義されているように、最新の C++ 機能を使用して MEX 関数を作成します。詳細については、MATLAB (MEX ファイル) から呼び出せる C++ 関数の記述を参照してください。

  • MEX 関数を R2017b 以前の MATLAB で実行しなければならない場合、または C 言語での作業が望ましい場合は、C 行列 APIおよび C MEX API の関数を使用してください。これらの API は MATLAB mxArray データ構造体を使用します。このページの関数とトピックは mxArray を基にしています。

メモ

C 行列 API または MATLAB データ API のいずれかから関数を選択してください。これらの API の関数を混用することはできません。

関数 mex を使用してソース ファイルから実行可能プログラムをビルドします。また、MEX ファイルは他の MATLAB ユーザーと共有できます。

S-Function 作成の詳細については、Simulink® ドキュメンテーションを参照してください。

他のユーザーが作成した MEX 関数を呼び出すには、MEX 関数の呼び出しを参照してください。

C/C++ プログラムから MATLAB 関数を呼び出す場合、いずれかのエンジン API を使用します。詳細については、以下を参照してください。

C プログラムから MATLAB のデータの読み取りおよび書き込みを行うには、MAT ファイル データを読み取る C プログラムの作成を参照してください。

関数

mexMEX 関数またはエンジン アプリケーションのビルド
dbmexUNIX プラットフォーム上で MEX ファイルのデバッグを有効にする

C MEX API

mexFunctionC 行列 API で作成された C/C++ MEX 関数へのエントリ ポイント
mexFunctionName現在の MEX 関数の名前
mexAtExitMEX 関数のクリア時または MATLAB の終了時に呼び出す関数を登録
mexCallMATLABMATLAB 関数、ユーザー定義関数または MEX 関数の呼び出し
mexCallMATLABWithTrapMATLAB 関数、ユーザー定義関数、または MEX ファイルの呼び出しと、エラー情報の取得
mexEvalString呼び出し側ワークスペース内での MATLAB コマンドの実行
mexEvalStringWithTrap呼び出し側のワークスペースで MATLAB コマンドを実行し、エラー情報を取得する
mexGetVariable指定されたワークスペースからの変数のコピー
mexGetVariablePtr別のワークスペースからの変数への読み取り専用ポインター
mexPutVariableMEX 関数から指定されたワークスペースへの配列
mexGet指定されたグラフィックス プロパティの値
mexSet指定されたグラフィックス プロパティの値の設定
mexPrintfANSI C PRINTF スタイル出力ルーチン
mexErrMsgIdAndTxt識別子と共にエラー メッセージを表示し、MATLAB プロンプトに戻る
mexWarnMsgIdAndTxt識別子を含む警告メッセージ
mexIsLockedMEX ファイルがロックされているかどうかの判別
mexLockメモリからの MEX ファイルのクリアの防止
mexUnlockメモリからの MEX ファイルのクリアを許可
mexMakeArrayPersistentMEX ファイルの完了後も配列を存続させる
mexMakeMemoryPersistentMATLAB によって割り当てられたメモリを MEX 関数の完了後も存続させる

トピック

C MEX 関数の記述

ビルド環境のテスト

C 行列 API のバージョン

MEX ファイルの共有

トラブルシューティング

ビルド エラー

実行時エラー

デバッグ

関連情報