外部インタフェース/API リファレンス | ![]() ![]() |
呼び出し側のワークスペース内のmxArray
のポインタを取得
Fortran 言語表示
integer*4 function mexGetMatrixPtr(name) character*(*) name
引数
name
呼び出し側のワークスペースから取得するmxArray
名。
戻り値
詳細
mexGetMatrixPtr
は、呼び出している関数のローカルなワークスペースで指定した名前をもつmxArray
のポインタを出力します。これにより、MEX-ファイルから直接MATLABワークスペースの変数を読み込み、変更することができます。
mexGetMatrixPtr
関数によって得られるmxArray
の、実部、虚部、スパース構造体を含むどの部分に関連するメモリも開放しないでください。この関数で得られたmxArray
は、MATLAB自身の内部メカニズムによって管理され、それらを変更した場合にはMATLABは直ちにクラッシュします。
mexGetMatrixPtr
は、mxArray
が同じサイズ、複雑度、スパース性のままである場合に、ワークスペース内のmxArray
から値を読み込んだり、それらの値を変更するために用いられます。
呼び出し関数によってグローバルと定義されていないグローバル変数のポインタを取得するには、最初にmexEvalString("global varname")
の形式の呼び出しによってグローバルと宣言してください。
![]() | mexGetMatrix | mexGetNaN | ![]() |