matGetNextVariable (C および Fortran)
MAT ファイル内の次の配列
C 構文
#include "mat.h" mxArray *matGetNextVariable(MATFile *mfp, const char **name);
Fortran 構文
#include "mat.h" mwPointer matGetNextVariable(mfp, name) mwPointer mfp character*(*) name
引数
mfp
MAT ファイル情報へのポインター
name
mxArray
名を含む変数へのポインター
戻り値
mfp
が指し示す MAT ファイルの次の mxArray
を表す、新たに割り当てられた mxArray
構造体へのポインター。mxArray
の名前が name
に返されます。
matGetNextVariable
は、ファイルの終端であるか、エラー状態が発生している場合には、C では NULL
(Fortran では 0
) を返します。C では、標準 C ライブラリの feof
および ferror
を使用してステータスを判断します。
説明
matGetNextVariable
は、MAT ファイルを順次処理し、単一パスで mxArray
をすべて読み取ることができるようにします。次の mxArray
は、mfp
が指し示す MAT ファイルから読み取られて返されます。
MAT ファイルを、他の MAT ファイル ルーチンではなく matOpen
で開いた直後に matGetNextVariable
を使用します。そうしないと、"次の" mxArray
の概念は定義されていません。
このルーチンによって作成された mxArray
が不要になったときは、mxDestroyArray
を使用して破棄します。
matGetNextVariable
に対する連続的な呼び出しから返される変数の順序が、変数が書き込まれた順序と同じになることは保証されません。
バージョン履歴
R2006a より前に導入