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 中具有指定标记的数据对象的数目。