mexGetVariable (Fortran)

指定されたワークスペースからの変数のコピー

Fortran 構文

#include "fintrf.h"
mwPointer mexGetVariable(workspace, varname)
character*(*) workspace, varname

引数

workspace

mexGetVariable が配列 varname を検索する場所を指定します。使用可能な値は以下のとおりです。

base

ベース ワークスペース内の変数を検索します。

caller

呼び出し側ワークスペース内の変数を検索します。

global

グローバル ワークスペース内の変数を検索します。

varname

コピーする変数の名前

戻り値

成功した場合は変数のコピー。失敗した場合は 0 を返します。失敗の一般的な原因は、ワークスペースに現在存在しない変数を指定することです。このような変数は以前にワークスペースに存在していても、クリアされている可能性があります。

説明

mexGetVariable を呼び出して、指定された変数のコピーを取得します。返された mxArray には、変数が他のワークスペースにもっていたデータと特性のすべてのコピーが含まれています。返された mxArray を変更しても、mexPutVariable を使用してコピーをワークスペースに書き戻さない限り、ワークスペース内の変数には影響しません。

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

バージョン履歴

R2006a より前に導入

参考

| |