matPutVariableAsGlobal (C および Fortran)

グローバル ワークスペースから発生した MAT ファイルの配列

C 構文

#include "mat.h"
int matPutVariableAsGlobal(MATFile *mfp, const char *name, const mxArray *pm);

Fortran 構文

#include "mat.h"
integer*4 matPutVariableAsGlobal(mfp, name, pm)
mwPointer mfp, pm
character*(*) name

引数

mfp

MAT ファイル情報へのポインター

name

MAT ファイルに配置する mxArray の名前

pm

mxArray ポインター

戻り値

成功した場合は 0、エラーが発生した場合は非ゼロ。C では、標準 C ライブラリの feof および ferror を matGetFp と共に使用してステータスを判断します。

説明

このルーチンは、mxArray を MAT ファイルに配置します。matPutVariableAsGlobal は matPutVariable と似ていますが、MATLAB® ソフトウェアは配列をグローバル ワークスペースに読み込み、その参照をローカル ワークスペースに設定する点において異なります。MATLAB 4 形式ファイルに書き込む場合、matPutVariableAsGlobal はファイルをグローバルとして読み込まず、matPutVariable と同じ結果になります。

matPutVariableAsGlobal は、mxArray pm を MAT ファイル mfp に書き込みます。mxArray が MAT ファイルに存在しない場合は、最後に追加されます。同じ名前の mxArray がファイルに存在する場合は、ファイルが書き換えられ、既存の mxArray が新しい mxArray に置換されます。

変数名には MATLAB 関数名を使用しないでください。関数名と競合する一般的な変数名には、i、j、mode、char、size、path などがあります。特定の名前が MATLAB 関数と関連しているかどうかを判断するには、関数 which を使用します。

新しい mxArray のサイズは既存の mxArray とは異なる場合があります。

例

例を開くには、次のように入力します。

edit([fullfile(matlabroot,"extern","examples","engmat","filename")]);

ここで filename は、次のようになります。

バージョン履歴

R2006a より前に導入

参考

|

トピック