Main Content

hdfv

HDF Vgroup (V) 接口的入口

语法

[out1,...,outN] = hdfv(funcstr,input1,...,inputN)

说明

hdfv 是 HDF Vgroup (V) 接口的 MATLAB® 入口。

[out1,...,outN] = hdfv(funcstr,input1,...,inputN) 返回与 HDF 库中由 functstr 指定的 V 函数对应的一个或多个输出。

HDF 库中的 V 函数与 funcstr 的有效值之间存在一对一的对应关系。例如,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 可以是 vdata id 或 vgroup id。
'addtagref'status = hdfv('addtagref',vgroup_id,tag,ref)将任何 HDF 数据对象添加到现有 vgroup。
'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 之前推出