C MEX ファイルアプリケーション

mxArray を使用して、R2017b 以前の MATLAB^® と連携して動作する C プログラムを作成

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

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

MathWorks では、MATLAB データ APIで定義されているように、最新の C++ 機能を使用して MEX 関数を作成することを推奨します。詳細については、C++ MEX アプリケーションを参照してください。
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/C++ プログラムから MATLAB のデータの読み取りおよび書き込みを行うには、MATLAB C API での MAT ファイルデータの読み取りを使用します。

関数

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

C MEX API

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