hdfv
HDF Vgroup (V) インターフェイスへのゲートウェイ
構文
[out1,...,outN] = hdfv(funcstr,input1,...,inputN)
説明
hdfv
は HDF Vgroup (V) インターフェイスへの MATLAB® ゲートウェイです。
[out1,...,outN] = hdfv(funcstr,input1,...,inputN)
は、functstr
で指定された HDF ライブラリの V 関数に対応する 1 つ以上の出力値を返します。
HDF ライブラリの V 関数と funcstr
の有効値の間には 1 対 1 の対応があります。たとえば、hdfv('nattrs',vgroup_id)
はC ライブラリの呼び出し Vnattrs(vgroup_id)
に相当します。
アクセス関数
アクセス関数は、ファイルを開き、Vgroup インターフェイスの初期化および個別のグループへのアクセスを実行します。また、vgroup と Vgroup インターフェイスへのアクセスを停止し、HDF ファイルを閉じます。
funcstr の値 | 関数構文 | 説明 |
---|---|---|
'start' | status = hdfv('start',file_id) | V インターフェイスの初期化 |
'attach' | vgroup_id = hdfv('attach',file_id,vgroup_ref,access) | vgroup へのアクセスを確立します。access は 'r' または 'w' のいずれかです。 |
'detach' | status = hdfv('detach',vgroup_id) | vgroup へのアクセスを停止します。 |
'end' | status = hdfv('end',file_id) | V インターフェイスへのアクセスを停止します。 |
作成関数
作成関数は、vgroup のデータ オブジェクトの整理、ラベル付け、追加を行います。
funcstr の値 | 関数構文 | 説明 |
---|---|---|
'setclass' | status = hdfv('setclass',vgroup_id,class) | vgroup にクラスを割り当てます。 |
'setname' | status = hdfv('setname',vgroup_id,name) | vgroup に名前を割り当てます。 |
'insert' | ref = hdfv('insert',vgroup_id, id) | 既存のグループに vgroup または vdata を追加します。id は vgroup ID または vdata ID のいずれかです。 |
'addtagref' | status = hdfv('addtagref',vgroup_id,tag,ref) | 既存の vgroup に任意の HDF データ オブジェクトを追加します。 |
'setattr' | status = hdfv('setattr',vgroup_id,name,A) | vgroup の属性を設定します。 |
ファイル問い合わせ関数
ファイル問い合わせ関数は、ファイルでの vgroup の格納方法に関する情報を返します。これはファイルで vgroup を検索する際に役立ちます。
funcstr の値 | 関数構文 | 説明 |
---|---|---|
'lone' | [refs,count] = hdfv('lone',file_id,maxsize) | 他の vgroup に含まれていない vgroup の参照番号を返します。 |
'getid' | next_ref = hdfv('getid',file_id,vgroup_ref) | HDF ファイル内の次の vgroup の参照番号を返します。 |
'find' | vgroup_ref = hdfv('find',file_id,vgroup_name) | 成功した場合は、指定された名前をもつ vgroup の参照番号を返します。失敗した場合は 0 を返します。 |
'findclass' | vgroup_ref = hdfv('findclass',file_id,class) | 指定されたクラスをもつ vgroup の参照番号を返します。 |
vgroup 問い合わせ関数
vgroup 問い合わせ関数は、特定の vgroup に関する特定の情報を提供します。この情報には、クラス、名前、メンバー数、メンバーに関する追加情報などがあります。
funcstr の値 | 関数構文 | 説明 |
---|---|---|
'getclass' | [class_name,status] = hdfv('getclass',vgroup_id) | 指定されたグループのクラス名を返します。 |
'getname' | [vgroup_name,status] = hdfv('getname',vgroup_id) | 指定されたグループの名前を返します。 |
'inquire' | [num_entries,name,status] = hdfv('inquire',vgroup_id) | vgroup のエントリ数と名前を返します。 |
'isvg' | status = hdfv('isvg',vgroup_id,ref) | ref で指定されたオブジェクトが、vgroup_id で指定された vgroup の子 vgroup を参照しているかどうかをチェックします。 |
'isvs' | status = hdfv('isvs',vgroup_id,vdata_ref) | vdata_ref で指定されたオブジェクトが、vgroup_id で指定された vgroup の子 vdata を参照しているかどうかをチェックします。 |
'gettagref' | [tag,ref,status] = hdfv('gettagref',vgroup_id,index) | 指定された vgroup のデータ オブジェクトに対するタグと参照番号のペアを取得します。 |
'ntagrefs' | count = hdfv('ntagrefs',vgroup_id) | 指定された vgroup に含まれるタグと参照番号のペアの数を取得します。 |
'gettagrefs' | [tag,refs,count] = hdfv('gettagrefs',vgroup_id,maxsize) | vgroup 内のすべてのデータ オブジェクトのタグと参照番号のペアを取得します。 |
'inqtagref' | tf = hdfv('inqtagref',vgroup_id,tag,ref) | オブジェクトが vgroup に属するかどうかをチェックします。 |
'getversion' | version = hdfv('getversion',vgroup_id) | 指定された vgroup の vgroup バージョンをクエリします。 |
'nattrs' | count = hdfv('nattrs',vgroup_id) | vgroup 属性の合計数をクエリします。 |
'attrinfo' | [name,data_type,count,nbytes,status] = hdfv('attrinfo',vgroup_id,... attr_index) | 指定された vgroup 属性に関する情報をクエリします。 |
'getattr' | [values,status] = hdfv('getattr',vgroup_id,attr_index) | 指定された属性の値をクエリします。 |
'Queryref' | ref = hdfv('Queryref',vgroup_id) | 指定された vgroup の参照番号を返します。 |
'Querytag' | tag = hdfv('Querytag',vgroup_id) | 指定された vgroup のタグを返します。 |
'flocate' | vdata_ref = hdfv('flocate',vgroup_id,field) | 指定された vgroup 内の、指定されたフィールド名を含む vdata の参照番号を返します。 |
'nrefs' | count = hdfv('nrefs',vgroup_id,tag) | 指定された vgroup の指定されたタグをもつデータ オブジェクトの数を返します。 |
出力引数
status
または識別子出力が -1 の場合は、操作が失敗したことを示します。
バージョン履歴
R2006a より前に導入