Main Content

hdfh

HDF H 接口的入口

语法

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

说明

hdfh 是 HDF H 接口的 MATLAB® 入口。

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

HDF 库中的 H 函数与 funcstr 的有效值之间存在一对一的对应关系。例如,hdfh('close',file_id) 对应于 C 库调用 Hclose(file_id)

函数

funcstr 的值函数语法描述
'appendable'

status = hdfh('appendable',access_id)

指定可以追加该元素。
'close'

status = hdfh('close',file_id)

关闭文件的访问路径。
'deldd'

status = hdfh('deldd',file_id,tag,ref)

从数据描述符列表中删除标记和引用编号。
'dupdd'

status = hdfh('dupdd',file_id,tag,ref,old_tag,old_ref)

 
'endaccess'

status = hdfh('endaccess',access_id)

通过处置访问标识符来终止对数据对象的访问。
'fidinquire'

[filename,access_mode,attach,status] = hdfh('fidinquire',file_id)

返回有关指定文件的信息。
'find'

[tag,ref,offset,length,status] = hdfh('find',file_id,... search_tag,search_ref,search_type,dir)

定位要在 HDF 文件中搜索的下一个对象。search_type 可以是 'new''continue'dir 输入可以是 'forward''backward'
'getelement'

[data,status] = hdfh('getelement',file_id,tag,ref)

读取指定标记和引用编号的数据元素。
'getfileversion'

[major,minor,release,info,status] = hdfh('getfileversion',file_id)

返回 HDF 文件的版本信息。
'getlibversion'

[major,minor,release,info,status] = hdfh('getlibversion')

返回当前 HDF 库的版本信息。
'inquire'

[file_id,tag,ref,length,offset,position,access,...
special,status] = hdfh('inquire',access_id)

返回有关数据元素的访问信息。
'ishdf'

tf = hdfh('ishdf',filename)

确定文件是否为 HDF 文件。
'length'

length = hdfh('length',file_id,tag,ref)

返回由标记和引用编号指定的数据对象的长度。
'newref'

ref = hdfh('newref',file_id)

返回可以与任意标记一起使用以生成一个唯一标记/引用编号对组的引用编号。
'nextread'

status = hdfh('nextread',access_id,tag,ref,origin)

搜索与指定的标记和引用编号匹配的下一个数据描述符。origin 可以是 'start''current'
'number'

num = hdfh('number',file_id,tag)

返沪文件中标记的实例数目。
'offset'

offset = hdfh('offset',file_id,tag,ref)

返回文件中数据元素的偏移量。
'open'

file_id = hdfh('open',filename,access,n_dds)

通过将所有数据描述符块读取到内存中来提供 HDF 文件的访问路径。
'putelement'

count = hdfh('putelement',file_id,tag,ref,X)

将数据元素写入 HDF 文件或替换其中的现有数据元素。X 必须为 uint8 数组。
'read'

X = hdfh('read',access_id,length)

读取数据元素中的下一段。
'seek'

status = hdfh('seek',access_id,offset,origin)

设置指向数据元素中的偏移量的访问指针。origin 可以是 'start''current'
'startread'

access_id = hdfh('startread',file_id,tag,ref)

 
'startwrite'

access_id = hdfh('startwrite',file_id,tag,ref,length)

 
'sync'

status = hdfh('sync',file_id)

 
'trunc'

length = hdfh('trunc',access_id,trunc_len)

将指定的数据对象截断为给定长度。
'write'

count = hdfh('write',access_id,X)

将下一个数据段写入指定的数据元素。X 必须为 uint8 数组。

输出参量

status 或标识符输出为 -1 表示操作失败。

局限性

  • hdfh 不支持 NCSA H 接口中的以下函数:

    • Hcache

    • Hendbitaccess

    • Hexist

    • Hflushdd

    • Hgetbit

    • Hputbit

    • Hsetlength

    • Hshutdown

    • Htagnewref

版本历史记录

在 R2006a 之前推出