engGetVariable (Fortran)

MATLAB エンジン ワークスペースからの変数のコピー

Fortran 構文

#include "engine.h"
mwPointer engGetVariable(ep, name)
mwPointer ep
character*(*) name

説明

engGetVariable は、ep に関連付けられている MATLAB^® エンジン セッションから、名前付き mxArray を読み取ります。成功した場合は 0、エラーが発生した場合は 1 を返します。

転送データのサイズ制限は 2 GB です。

このルーチンによって作成された mxArray が不要になったときは、mxDestroyArray を使用して破棄します。

入力引数

ep — エンジンへのポインター

mwPointer

エンジンへのポインター。mwPointer として指定します。

name — mxArray の名前

character*(*)

MATLAB ワークスペースから取得する mxArray の名前。character*(*) として指定します。

pm — mxArray へのポインター

mwPointer

mxArray へのポインター。mwPointer として指定します。

出力引数

ptr — mxArray へのポインター

mwPointer | NULL

新たに割り当てられた mxArray 構造体へのポインター。mwPointer として返されます。試行に失敗した場合は NULL が返されます。名前付き変数が存在しない場合、engGetVariable は失敗します。

バージョン履歴

R2006a より前に導入

参考

mxDestroyArray | engPutVariable