Main Content

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 より前に導入