ドキュメンテーション センター

  • 評価版
  • 製品アップデート

目次

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

matGetVariableInfo (C および Fortran)

配列ヘッダー情報のみ

C 構文

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

Fortran 構文

mwPointer matGetVariableInfo(mfp, name)
mwPointer mfp
character*(*) name

引数

mfp

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

name

MAT ファイルから取得する mxArray の名前

戻り値

mfp が指し示す MAT ファイルからの name の名前をもつ mxArray のヘッダー情報を表す、新たに割り当てられた mxArray 構造体へのポインター。

name の名前をもつ mxArray のヘッダー情報を返すことができなかった場合、関数 matGetVariableInfo は C では NULL (Fortran では 0) を返します。

説明

matGetVariableInfo は、prpiir、および jc 以外のすべてを含む配列ヘッダー情報のみを読み込みます。リーフ要素を通じてセルや構造体が再帰的に作成されますが、prpiir、および jc は含まれません。

関数 matGetVariable での読み込み時に prpiir、および jc が非ゼロ値の場合、関数 matGetVariableInfo はこれらを代わりに -1 に設定します。これらのヘッダーは情報の提供のみが目的です。このデータを MATLAB® ワークスペースに渡したり、MAT ファイルに保存することは決してしないでください。

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

この情報は役に立ちましたか?