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

mex

C/C++ または Fortran のソースコードから MEX 関数をビルドする

ページ内をすべて折りたたむ

構文

mex filenames

mex option1 ... optionN filenames

mex -setup lang

mex -setup -client engine [lang]

説明

例

メモ

mex コマンドは、MATLAB データ API、C 行列 API およびFortran 行列 APIで記述された MEX 関数とエンジンアプリケーションをビルドします。

mex filenames は、1 つ以上の C、C++ または Fortran のソースファイルをコンパイルしてリンクし、MATLAB^® から呼び出すことができるバイナリ MEX ファイルを作成します。filenames は、ソースファイルを指定します。また、スタンドアロンの MATLAB エンジンおよび MAT ファイルアプリケーションの実行可能ファイルもビルドします。

MATLAB は、コンパイラがインストールされている場合には、filenames 引数の言語に基づいて、自動的にコンパイラを選択します。

例

mex option1 ... optionN filenames は、指定されたビルドオプションを使用してビルドします。option1 ... optionN 引数は、既定の mex ビルド構成を補足またはオーバーライドします。

mex -setup lang は、指定された lang に対するコンパイラを選択します。指定された言語に対する既定のコンパイラを変更するには、このオプションを使用します。

mex -setup -client engine [lang] はエンジンアプリケーションをビルドするためのコンパイラを選択します。既定のコンパイラを変更する場合はこのオプションを使用します。引数 lang を使用して Fortran または C++ のコンパイラを選択します。

例

すべて折りたたむ

C の MEX ファイルをビルドする

スクリプトを開く

単一の C プログラム yprime.c を MEX ファイルにビルドします。

パス c:\work に書き込み可能フォルダーを作成し、現在のフォルダーとして設定します。

[s,msg,msgid] = mkdir('c:\work');
if (isempty(msgid))
    mkdir('c:\work')
end
cd c:\work

matlabroot/extern/examples フォルダーからソースコードの例をコピーします。

copyfile(fullfile(matlabroot,'extern','examples','mex','yprime.c'),'.','f')

MEX ファイルをビルドします。出力には、コンパイラ固有の情報が表示されます。

mex yprime.c

Building with 'MinGW64 Compiler  C '.
MEX completed successfully.

テストします。

T=1;
Y=1:4;
yprime(T,Y)

ans =

    2.0000    8.9685    4.0000   -1.0947

ビルドとトラブルシューティングの詳細情報の表示

コンパイルやリンクのコマンドおよびトラブルシューティングに役立つその他の情報を表示するには、詳細モードを使用します。

mex -v -compatibleArrayDims yprime.c

出力には、プラットフォームおよびコンパイラ固有の情報が表示されます。

既定のコンパイラスイッチオプションのオーバーライド

値 -Wall を既存のコンパイラフラグに付加して、yprime.c MEX ファイルをビルドします。値にスペース文字が含まれているので、文字列を区切らなければなりません。使用する区切り文字はプラットフォームに依存します。

MATLAB プロンプトでは MATLAB の一重引用符 (') を使用してください。

mex -v COMPFLAGS='$COMPFLAGS -Wall' yprime.c

gcc/g++ を基にした MinGW-w64 コンパイラでは、Linux^® コンパイラフラグを使用します。

mex -v CXXFLAGS='$CXXFLAGS -Wall' yprime.c

Windows^® コマンドプロンプトでは二重引用符 (") を使用してください。

mex -v COMPFLAGS="$COMPFLAGS -Wall" yprime.c

Mac と Linux 上のシェルコマンドラインでは、一重引用符 (') を使用してください。

mex -v CFLAGS='$CFLAGS -Wall' yprime.c

複数のソースファイルから MEX ファイルをビルドする

スクリプトを開く

MEX ファイルの例 fulltosparse は、loadsparse.F と fulltosparse.F の 2 つの Fortran ソースファイルで構成されます。この例を実行するには、サポートされる Fortran コンパイラがシステムにインストールされている必要があります。

ソースファイルを現在のフォルダーにコピーします。

copyfile(fullfile(matlabroot,'extern','examples','refbook','loadsparse.F'),'.','f')
copyfile(fullfile(matlabroot,'extern','examples','refbook','fulltosparse.F'),'.','f')

fulltosparse MEX ファイルをビルドします。コマンドラインの最初のファイルが fulltosparse.F なので、MEX ファイルの名前は fulltosparse です。出力には、コンパイラ固有の情報が格納されます。

mex -largeArrayDims fulltosparse.F loadsparse.F

Building with 'Intel Visual Fortran Composer XE 2013 with Microsoft Visual Studio 2012'.
MEX completed successfully.

テストします。

full = eye(5);
spar = fulltosparse(full)

spar =

    1,1         1
    2,2         1
    3,3         1
    4,4         1
    5,5         1

ワイルドカードを使用したソースファイルの結合

現在のフォルダー内のすべての C ソースファイルを MEX ファイル mymex にまとめます。MEX ファイルの名前を制御するには、-output オプションを使用します。

mex -output mymex *.c

ビルドコマンドをプレビューする

ビルドコマンドを実行せずにその詳細をプレビューするには、-n オプションを使用します。出力には、プラットフォームおよびコンパイラ固有の情報が格納されます。

mex -n yprime.c

個別のオブジェクトファイルへのリンクを作成する

スクリプトを開く

ソース MEX ファイルとは別にコンパイルするオブジェクトファイルにリンクすることができます。

MEX ファイルの例 fulltosparse は、2 つの Fortran ソースファイルで構成されます。fulltosparse ファイルは、mexFunction サブルーチンを含むゲートウェイルーチンです。loadsparse には、計算ルーチンが含まれています。

この例を実行するには、サポートされる Fortran コンパイラがシステムにインストールされている必要があります。計算サブルーチンを現在のフォルダーにコピーします。

copyfile(fullfile(matlabroot,'extern','examples','refbook','loadsparse.F'),'.','f')

サブルーチンをコンパイルし、オブジェクトファイルを別のフォルダー c:\objfiles に配置します。

mkdir c:\objfiles
mex -largeArrayDims -c -outdir c:\objfiles loadsparse.F

Building with 'Intel Visual Fortran Composer XE 2013 with Microsoft Visual Studio 2012'.
MEX completed successfully.

ゲートウェイサブルーチンを現在のフォルダーにコピーします。コンパイルして loadsparse オブジェクトファイルとリンクします。

copyfile(fullfile(matlabroot,'extern','examples','refbook','fulltosparse.F'),'.','f')
mex -largeArrayDims fulltosparse.F c:\objfiles\loadsparse.obj

Building with 'Intel Visual Fortran Composer XE 2013 with Microsoft Visual Studio 2012'.
MEX completed successfully.

インクルードファイルへのパスを指定する

複素数ルーチンを処理するための MATLAB LAPACK ライブラリサブルーチンをインクルードするパスを指定するには、-I オプションを使用します。これらのサブルーチンを使用するには、MEX ファイルがヘッダーファイル fort.h にアクセスしなければなりません。

matrixDivideComplex.c 例を現在のフォルダーにコピーします。

copyfile(fullfile(matlabroot,'extern','examples','refbook','matrixDivideComplex.c'),'.','f')

'-I' と fort.h ファイルへのパスを連結して -I 引数を作成します。

ipath = ['-I' fullfile(matlabroot,'extern','examples','refbook')];

LAPACK ライブラリファイルの名前とパスを表す変数と複素数処理ルーチンを含むファイル fort.c を作成します。

lapacklib = fullfile(matlabroot,'extern','lib',computer('arch'),'microsoft','libmwlapack.lib');
fortfile = fullfile(matlabroot,'extern','examples','refbook','fort.c');

MEX ファイルをビルドします。

mex('-v','-R2017b',ipath,'matrixDivideComplex.c',fortfile,lapacklib)

ライブラリファイルへのパスを指定する

Windows プラットフォームで matrixDivide.c の例をビルドします。これには -L および -l オプションを使用して、libmwlapack.lib ライブラリを指定します。ライブラリファイルは matlabroot\extern\lib\arch\microsoft フォルダーにあります。

matrixDivide.c 例を現在のフォルダーにコピーします。

copyfile(fullfile(matlabroot,'extern','examples','refbook','matrixDivide.c'),'.','f')

matlabroot の値を取得します。

matlabroot

ans =

C:\Program Files\MATLAB\R2014a

arch の値を取得します。

computer('arch')

ans =

win64

MEX ファイルをビルドするには、以下のステートメントに示すように、matlabroot と arch の値を mex コマンドにコピーします。

mex '-LC:\Program Files\MATLAB\R2014a\extern\lib\win64\microsoft'...
   -llibmwlapack matrixDivide.c

パスの \Program Files にはスペースが含まれているので、文字 ' を使用しなければなりません。

コンパイラ命令を定義

スクリプトを開く

例 mxcreatecharmatrixfromstr.c では、#define シンボル SPACE_PADDING を使用して、行列内の文字ベクトル間にどの文字を使うかを定義します。値を設定するには、-D オプションを使用して MEX ファイルをビルドします。

例を現在のフォルダーにコピーします。

copyfile(fullfile(matlabroot,'extern','examples','mx','mxcreatecharmatrixfromstr.c'),'.','f')

SPACE_PADDING 命令を設定して、値の間にスペースを追加します。

mex mxcreatecharmatrixfromstr.c -DSPACE_PADDING

Building with 'MinGW64 Compiler  C '.
MEX completed successfully.

エンジンアプリケーションをビルドする

engwindemo.c エンジンの例を現在のフォルダーにコピーします。

copyfile(fullfile(matlabroot,'extern','examples','eng_mat','engwindemo.c'),'.','f')

mex -client engine engwindemo.c

Windows プラットフォームを使用している場合、最初に MATLAB を COM サーバーとして登録しなければなりません。詳細については、COM サーバーとしての MATLAB の登録を参照してください。

例を実行します。

!engwindemo

C コンパイラを選択する

mex -setup

MATLAB は Supported and Compatible Compilers のリストに基づいて、お使いのバージョンおよびシステム用のオプションを表示します。

入力引数

すべて折りたたむ

`filenames` — 1 つまたは複数のファイル名
string | 文字ベクトル

名前とファイル拡張子を含む 1 つ以上のファイル名。string または文字ベクトルとして指定します。ファイルが現在のフォルダーにない場合は、ファイルへの絶対パスを指定します。

ファイル名には、以下を任意に組み合わせることができます。

C、C++ または Fortran 言語のソースファイル
Simulink^® S-Function ファイル
オブジェクトファイル
スタティックライブラリファイル。ダイナミックライブラリをリンクする場合は、-llibname オプションを使用します。

filenames のリストに最初に現れるソースコードファイルが、バイナリ MEX ファイルの名前になります。この命名規則をオーバーライドするには、'-output' オプションを使用します。

データ型: char

`option1 ... optionN` — 1 つまたは複数のビルドオプション
有効なオプションフラグに対応する string または文字ベクトル

1 つまたは複数のビルドオプション。以下のいずれかの値として指定します。オプションは、指示がある場合を除き、任意のプラットフォームで任意の順序で指定できます。

オプション	説明
`@rspfile`	Windows RSP ファイルを使用します。RSP ファイルは、コマンドラインオプションを含むテキストファイルです。非 ASCII 文字はサポートされません。
`-c`	オブジェクトファイルのみをコンパイルします。バイナリ MEX ファイルはビルドしません。
`-client engine`	エンジンアプリケーションをビルドします。
`-Dsymbolname` `-Dsymbolname=symbolvalue` `-Usymbolname`	`-D` オプションは、C プリプロセッサマクロを定義します。ソースファイル内での以下と等価です。 `#define` `symbolname` `#define` `symbolname` `symbolvalue` `-U` オプションは、C プリプロセッサマクロ `symbolname` のすべての初期定義を削除します(`-D` オプションの逆)。 D または U と `symbolname` との間にスペースを追加しないでください。= 記号の前後にスペースを追加しないでください。例: コンパイラ命令を定義
`-f filepath`	エンジンアプリケーションをビルドするには、`-client engine` オプションを使用します。 `mex` コンフィギュレーションファイルの名前と場所を指定します。既定のコンパイラの選択をオーバーライドします。既定以外のコンパイラを使用する場合の詳細については、既定のコンパイラの変更を参照してください。`filepath` は、コンフィギュレーションファイルの名前と絶対パスであり、string または文字ベクトルとして指定されます。
`-g`	シンボリック情報を追加し、ビルドされたオブジェクトコードの最適化を無効にします。デバッグに使用します。最適化を使用してデバッグする場合は、`-O` オプションを追加します。
`-h[elp]`	`mex` のヘルプを表示します。オペレーティングシステムのプロンプトから使用します。
`-Ipathname`	`#include` ファイルを検索するフォルダーのリストへ `pathname` を追加します。 I と `pathname` の間にスペースを追加しないでください。例: インクルードファイルへのパスを指定する
`-llibname` `-Llibfolder -llibname`	ダイナミックオブジェクトライブラリ `libname` とリンクします。オプションでフォルダー `libfolder` を指定できます。 MATLAB は `libname` を以下のファイルに展開します。 `libname.lib` または `liblibname.lib` — Windows システム `liblibname.dylib` — Mac システム `liblibname.so` — Linux システム使用する場合、`-L` オプションは `-l` オプションの前に置かなければなりません。Linux または Mac システムで `-L` オプションを使用する場合は、ランタイムライブラリパスの設定で説明されているとおり、ランタイムライブラリのパスも設定しなければなりません。 l と `libname` の間、または L と `libfolder` の間にスペースを追加しないでください。 `-l` オプションは小文字の L で指定します。スタティックライブラリをリンクするには、`filenames` 入力引数を使用します。例: ライブラリファイルへのパスを指定する
`-n`	`mex` が実行するコマンドを表示します。ただし、実行はしません。例: ビルドコマンドをプレビューする
`-O`	オブジェクトコードを最適化します。最適化を使用してコンパイルするには、このオプションを使用します。最適化は既定で有効になっています。`-g` オプションを `-O` オプションなしで入力すると、最適化は無効になります。このオプションは大文字の O で指定します。
`-outdir dirname`	すべての出力ファイルをフォルダー `dirname` へ保存します。例: 個別のオブジェクトファイルへのリンクを作成する
`-output mexname`	既定の MEX ファイル命名メカニズムをオーバーライドします。適切な MEX ファイル拡張子をもつ、`mexname` という名前のバイナリ MEX ファイルを作成します。例: ワイルドカードを使用したソースファイルの結合
`-R2017b` (既定) `-R2018a` `-largeArrayDims` `-compatibleArrayDims`	指定された MATLAB 配列ハンドリング C または Fortran Matrix API とリンクします。このオプションは、MATLAB データ API を使用する MEX ファイルまたはエンジンアプリケーションに使用しないでください。 `-R2017b` — 既定のオプション。`-R2017b` は `-largeArrayDims` オプションを使用し、グラフィックスオブジェクトのハンドルを `double` ではなく `object` として扱います。 `-R2018a` — インターリーブされた複素数 API を使用します。これには型付きのデータアクセス関数が含まれます。 MATLAB R2018a で、インターリーブされた複素数 API によってビルドされた Fortran MEX ファイルを実行するには、MATLAB R2018a Update 3 を使用しなければなりません。 `-largeArrayDims` — MATLAB 大規模配列ハンドリング API を使用します。この API は、要素数が 2³¹-1 を超える配列を扱います。LAPACK または BLAS 関数を呼び出すときには、このオプションを使用しなければなりません。 `-compatibleArrayDims` — MATLAB Version 7.2 の配列ハンドリング API を使用します。これは、配列の要素数を 2³¹-1 に制限します。C MEX S-Function のみで既定のオプション。
`-setup lang`	`lang` 言語 MEX ファイルをビルドするように、既定のコンパイラを変更します。このオプションを使用すると、`mex` はその他のコマンドラインオプションをすべて無視します。
`-silent`	情報を伝えるメッセージを非表示にします。`mex` コマンドは、`-silent` を指定した場合でもエラーと警告を報告します。
`-Usymbolname`	C プリプロセッサマクロの `symbolname` のすべての初期定義を削除します(`-D` オプションの逆)。 U と `symbolname` の間にスペースを追加しないでください。
`-v`	詳細モードでビルドします。すべてのコマンドライン引数が処理された後、内部変数の値を表示します。コンパイルおよびリンクの各ステップのすべての評価を表示します。コンパイラ設定の問題のトラブルシューティングに使用します。例: ビルドとトラブルシューティングの詳細情報の表示
`varname=varvalue`	変数 `varname` の既定の設定をオーバーライドします。コマンドライン引数がすべて処理された後に、このオプションが処理されます。例: 既定のコンパイラスイッチオプションのオーバーライド.

`lang` — 言語
`C` (既定値) | `C++` | `CPP` | `Fortran`

言語。次の値のいずれかとして指定します。

`C`	C コンパイラ (C++ を含む)。
`C++` または `CPP`	C++ コンパイラ。
`Fortran`	Fortran コンパイラ。

ヒント

mex は以下の場所から実行できます。
- MATLAB コマンドウィンドウ
- Windows システムプロンプト
- Mac ターミナル
- Linux シェル
MATLAB 以外のコマンドラインで使用する場合、mex プログラムは、[matlabroot '/bin'] で指定されたフォルダーに格納されています。
MEX ファイルの拡張子はプラットフォームによって異なります。さまざまなプラットフォーム用のバイナリ MEX ファイルを同じフォルダーに配置できます。

MEX ファイルのプラットフォーム依存の拡張子
プラットフォームバイナリ MEX ファイルの拡張子
Linux (64 ビット)
mexa64
Apple Mac (64 ビット)
mexmaci64
Windows (64 ビット)
mexw64

MEX ファイルの拡張子を識別するには、関数 mexext を使用してください。
mex を使用してスタンドアロンの MATLAB エンジンと MAT ファイルのアプリケーションの実行可能ファイルをビルドするには、-client engine オプションを使用してください。
mex コマンドは、二重引用符 (") を含むフォルダー名をサポートしません。

mex

構文

説明

メモ

例

C の MEX ファイルをビルドする

ビルドとトラブルシューティングの詳細情報の表示

既定のコンパイラスイッチオプションのオーバーライド

複数のソースファイルから MEX ファイルをビルドする

ワイルドカードを使用したソースファイルの結合

ビルドコマンドをプレビューする

個別のオブジェクトファイルへのリンクを作成する

インクルードファイルへのパスを指定する

ライブラリファイルへのパスを指定する

コンパイラ命令を定義

エンジンアプリケーションをビルドする

C コンパイラを選択する

入力引数

`filenames` — 1 つまたは複数のファイル名
string | 文字ベクトル

`option1 ... optionN` — 1 つまたは複数のビルドオプション
有効なオプションフラグに対応する string または文字ベクトル

`lang` — 言語
`C` (既定値) | `C++` | `CPP` | `Fortran`

ヒント

参考

トピック

外部の Web サイト

R2006a より前に導入

MATLAB ドキュメンテーション

サポート

MATLABで始めるディープラーニング

プラットフォーム	バイナリ MEX ファイルの拡張子
Linux (64 ビット)	`mexa64`
Apple Mac (64 ビット)	`mexmaci64`
Windows (64 ビット)	`mexw64`

mex

構文

説明

メモ

例

C の MEX ファイルをビルドする

ビルドとトラブルシューティングの詳細情報の表示

既定のコンパイラ スイッチ オプションのオーバーライド

複数のソース ファイルから MEX ファイルをビルドする

ワイルドカードを使用したソース ファイルの結合

ビルド コマンドをプレビューする

個別のオブジェクト ファイルへのリンクを作成する

インクルード ファイルへのパスを指定する

ライブラリ ファイルへのパスを指定する

コンパイラ命令を定義

エンジン アプリケーションをビルドする

C コンパイラを選択する

入力引数

filenames — 1 つまたは複数のファイル名 string | 文字ベクトル

option1 ... optionN — 1 つまたは複数のビルド オプション 有効なオプション フラグに対応する string または文字ベクトル

lang — 言語 C (既定値) | C++ | CPP | Fortran

ヒント

参考

トピック

外部の Web サイト

R2006a より前に導入

MATLAB ドキュメンテーション

サポート

MATLABで始めるディープラーニング

既定のコンパイラスイッチオプションのオーバーライド

複数のソースファイルから MEX ファイルをビルドする

ワイルドカードを使用したソースファイルの結合

ビルドコマンドをプレビューする

個別のオブジェクトファイルへのリンクを作成する

インクルードファイルへのパスを指定する

ライブラリファイルへのパスを指定する

エンジンアプリケーションをビルドする

`filenames` — 1 つまたは複数のファイル名
string | 文字ベクトル

`option1 ... optionN` — 1 つまたは複数のビルドオプション
有効なオプションフラグに対応する string または文字ベクトル

`lang` — 言語
`C` (既定値) | `C++` | `CPP` | `Fortran`