C/C++ MEX ファイルを MinGW -w64 でコンパイルする際のトラブルシューティングと制限

MinGW 以外のコンパイラでコンパイルしたライブラリファイルにリンクしない

MinGW^® コンパイラを使用して、Microsoft^® Visual Studio^® など、MinGW 以外のコンパイラでコンパイルしたライブラリにリンクする MEX ファイルをビルドした場合、そのファイルは MATLAB^® では実行されません。異なるコンパイラで生成されたライブラリ (.lib) ファイルは、互いに互換性がありません。

MinGW の dlltool ユーティリティを使用して、新しいライブラリファイルを生成できます。

MinGW インストールフォルダーにスペースを含めない

MinGW は、パス名にスペースを含む場所にはインストールしないでください。たとえば、次は使用しないでください。

C:\Program Files\mingw-64

代わりに次を使用してください。

C:\mingw-64

MEX コマンドが MinGW を選択しない

MinGW コンパイラのみがシステムにインストールされている場合、mex コマンドは C および C++ MEX ファイルの両方に対し自動的に MinGW を選択します。複数の C または C++ コンパイラがある場合は、mex -setup を使用して C および (必要に応じて) C++ MEX ファイルの両方に MinGW を選択します。

mex -setup
mex -setup cpp

mex -setup とだけ入力して MinGW を選択すると、C++ ファイルをコンパイルする際に、mex は別のコンパイラを選択する可能性があります。

MinGW を MATLAB 用に手動設定

MinGW を MATLAB の [アドオン] メニューからインストールすると、MATLAB は MinGW コンパイラを自動検出します。

Windows^® の管理者権限がある場合は、configuremingw スクリプトを使用して、必要に応じて MinGW を手動で構成できます。このスクリプトをダウンロードする方法は、MATLAB Answers の記事 "I already have MinGW on my computer.How do I configure it to work with MATLAB" を参照してください。

MinGW が Linux 上の gcc/g++ と同様の動作を示す

mex コマンドを使用してコンパイラフラグを変更する場合は、Windows のフラグ COMPFLAGS の代わりに Linux^® のコンパイラフラグ CFLAGS または CXXFLAGS を使用します。

MEX 例外の使用における C++ MEX ファイル内でのメモリリークの可能性

MinGW-w64 コンパイラでコンパイルされた C++ MEX ファイルでのエラー処理は、MATLAB のエラー処理と整合性がありません。C++ MEX ファイルにクラスが含まれている場合、関数 mexErrMsgIdAndTxt を使用して MEX の例外をスローすると、そのクラス用に作成されたオブジェクトにメモリリークが発生する可能性があります。

MathWorks では、C 行列 API の代わりに C++ MEX API を使用することを推奨しています。詳細については、MATLAB (MEX ファイル) から呼び出せる C++ 関数の記述を参照してください。

たとえば、次の C++ MEX 関数には MyClass クラスが含まれています。

#include "mex.h"
 
class MyClass { 
    public:
        MyClass() {
            mexPrintf("Constructor called");
        }
        ~MyClass() {
            mexPrintf("Destructor called");
        }
};
 
void mexFunction(int nlhs, mxArray *plhs[], int nrhs, const mxArray *prhs[])
{
    MyClass X;
    
    if (nrhs != 0) { 
	    mexErrMsgIdAndTxt("MATLAB:cppfeature:invalidNumInputs",
                "No input arguments allowed."); 
    } 
}

MEX 関数はオブジェクト X を MyClass から作成し、次に入力引数の数をチェックします。MEX 関数が mexErrMsgIdAndTxt を呼び出した場合、MATLAB のエラー処理ではオブジェクト X のメモリが解放されず、したがって、メモリリークが発生します。

C++ MEX ファイルにおける未処理の明示的例外による MATLAB の予期しない終了

C++ MEX ファイルの関数が明示的な例外をスローし、その例外が MEX ファイル内で catch ステートメントによりキャッチされない場合は、エラーは MATLAB コマンドラインに伝播されず、例外によって MATLAB が終了します。

#include "mex.h"

class error {}; // Throw an exception of this class

class MyClass
{
    public:
    MyClass(){
        mexPrintf("Constructor called.");
    }
    ~MyClass(){
        mexPrintf("Destructor called.");
    }
};

void doErrorChecking(const MyClass& obj)
{
    // Do error checking
    throw error();
}

void createMyClass()
{
    MyClass myobj;
    doErrorChecking(myobj);
}

void mexFunction(int nlhs, mxArray *plhs[], int nrhs, const mxArray *prhs[])
{
    createMyClass();
}

MEX 関数は createMyClass を呼び出し、これによってクラス MyClass のオブジェクトが作成されて、関数 doErrorChecking が呼び出されます。関数 doErrorChecking は error タイプの例外をスローします。しかし、この例外は MEX ファイル内ではキャッチされず、MATLAB のクラッシュを引き起こします。

この動作は、std::exception クラスから継承されたクラスに対しても発生します。

回避方法

例外を MEX 関数でキャッチします。

void mexFunction(int nlhs, mxArray *plhs[], int nrhs, const mxArray *prhs[])
{
    try{
        createMyClass();
    }
    catch(error e){
        // Error handling
    }
}