外部インタフェース/API リファレンス

matGetNextArray

MAT-ファイルからつぎのmxArrayを読み込む

C 言語表示

#include "mat.h"
mxArray *matGetNextArray(MATFile *mfp);

引数
mfp
   MAT-ファイル情報のポインタ。

詳細

matGetNextArrayは、MAT-ファイルをシーケンシャルに進めて、1つのパス内のすべてのmxArrayを読み込みます。

matGetNextArrayは、mfpによって指し示されるMAT-ファイルからつぎのmxArrayを読み込み、新たに割り当てられたmxArray構造体のポインタを出力します。matOpenを使ってMAT-ファイルをオープンしたら、直ちにこの関数を使ってください。また、他のMAT-ファイルルーチンと一緒にこの関数を使わないでください。そうしないと、つぎの mxArrayの意味が不明になります。

matGetNextArrayは、end-of-fileに到達したときや、エラーコンディションがある場合には、NULLを出力します。ステータスを決定するためには、標準のCのライブラリからfeofおよびferrorを使ってください。

終了するときに、このルーチンによって作成されたmxArrayをコード内で開放するようにしてください。

例題

CのプログラムでMATLABのMAT-ファイルルーチンを用いる方法を説明するサンプルプログラムは、examplesディレクトリのeng_matサブディレクトリのmatcreat.cとmatdgns.cを参照してください。

matGetMatrix (廃版)

matGetNextArrayHeader