主要内容

链接(H5L)

在HDF5文件链接

描述

使用MATLAB®HDF5链接接口,H5L创建和操作链接,HDF5组。这个接口包含函数,使创建和使用用户定义的链接类。

功能

H5L.copy

从源位置链接复制到目标位置

H5L.copy (srcID、srcname destID、destname lcplID, laplID)复制链接指定的srcname从指定的文件或组srcID到目的地destID。创建链接的新副本的名称destname

细节

H5L.create_external

创建软链接到外部对象

链接名,H5L.create_external(文件名,objname linkID lcplID, laplID)创建一个软链接到一个对象在不同的文件中。

细节

H5L.create_hard

创建硬链接

H5L.create_hard (objID objname linkID,链接名,lcplID, laplID)创建一个新的硬链接以HDF5先前存在的对象文件。许多的新链接可能是指向该对象。

细节

H5L.create_soft

创建软链接

H5L.create_soft(定位路径、linkID链接名,lcplID laplID)创建一个新的软链接到一个对象在一个HDF5文件。许多的新链接可能是指向该对象即。,新的软链接指向的对象。

细节

H5L.delete

删除链接

H5L.delete (locID、名称、laplID)删除指定的链接的名字的位置locID基于链接访问属性列表所指定的标识符laplID

H5L.exists

确定链接的存在

输出= H5L.exists(链接名,locID laplID)返回一个积极价值如果链接指定的配对对象的标识符locID和名字链接名基于链接访问属性列表所指定的标识符laplID,存在。如果该链接不存在,H5L.exists可以返回0或生成一个错误。进一步的细节,请参阅HDF5文档。

H5L.get_info

信息链接

链接名,linkStruct = H5L.get_info (locID laplID)返回一个链接的信息。一个文件或一组标识符,locID,指定链接的位置。的链接名论点,解释的相对linkID指定查询的链接。

H5L.get_name_by_idx

指定的索引信息链接

name = H5L.get_name_by_idx (locID groupname idxtype,秩序,n, laplID)检索信息链接索引n出现在组groupname在位置locID

name = H5L.get_name_by_idx (locID groupname idxtype,秩序,n, laplID,“TextEncoding”,编码)另外指定链接的文本编码用来解释的名字。

细节

H5L.get_val

符号链接的价值

链接名,linkval = H5L.get_val (linklocID laplID)返回一个符号链接的价值。这个函数对应H5L.get_valH5Lunpack_elink_valHDF5 1.8 C API函数。

laplID linkval = H5L.get_val (linklocID链接名,“TextEncoding”,编码)另外指定链接的文本编码用来解释价值。

细节

H5L.iterate

遍历链接组或文件组或指定的文件标识符

(状态、idxOut opdataOut) = H5L.iterate (fnc idxtype groupID,秩序,idxIn, opdataIn)遍历指定的组或文件的链接groupID执行常见函数的函数句柄fncH5L.iterate不递归地链接到指定组的子组。

细节

H5L.iterate_by_name

遍历链接组或文件中指定的位置和组名

(状态、idxOut opdataOut) = H5L.iterate_by_name (locID、groupname idxtype,秩序,idxIn, fnc, opdataIn, laplID)遍历一组中的链接或文件执行常见函数的函数句柄fnc。迭代的起点是由一个位置标识符和一个相对的组名。H5L.iterate_by_name不递归地链接到指定组的子组。一个链接访问属性列表,laplID,可能影响结果取决于类型的链接被遍历。

细节

H5L.move

重命名链接

H5L.move (srcID、srcname destID、destname lcplID, laplID)在一个HDF5文件重命名一个链接。原来的链接,srcname从组中删除图和新的链接,destname插入。这种变化是作为一个原子操作来完成的。

细节

H5L.visit

递归地遍历链接组或文件组或指定的文件标识符

(地位、opdataOut) = H5L.visit (idxtype groupID,秩序,fnc opdataIn)递归地遍历所有的链接在下面指定的组或文件groupID执行常见函数的函数句柄fnc

细节

H5L.visit_by_name

递归地遍历链接组或文件中指定的位置和组名

(地位、opdataOut) = H5L.visit_by_name (locID、groupname idxtype,秩序,fnc, opdataIn, laplID)递归地遍历所有链接在下面的组或文件来执行一个共同的功能函数句柄fnc。迭代的起点是由一个位置标识符和一个相对的组名。一个链接访问属性列表,laplID,可能影响结果取决于类型的链接被遍历。

细节

例子

全部展开

删除唯一的链接“g3 /”集团example.h5

srcFile = fullfile (matlabroot,“工具箱”,“matlab”,“演示”,“example.h5”);拷贝文件(srcFile“myfile.h5”);fileattrib (“myfile.h5”,“+ w”);fid = H5F.open (“myfile.h5”,“H5F_ACC_RDWR”,“H5P_DEFAULT”);H5L.delete (fid检测器,“g3”,“H5P_DEFAULT”);H5F.close (fid);
fid = H5F.open (“example.h5”);gid = H5G.open (fid,“/ g1 / g1.2 / g1.2.1”);如果H5L.exists (gid,“偷偷”,“H5P_DEFAULT”)流(“链接存在\ n”);其他的流(“链接不存在\ n”);结束H5G.close (gid);H5F.close (fid);

重命名“/ g2”集团“g3 / g2 /”

srcFile = fullfile (matlabroot,“工具箱”,“matlab”,“演示”,“example.h5”);拷贝文件(srcFile“myfile.h5”);fileattrib (“myfile.h5”,“+ w”);fid = H5F.open (“myfile.h5”,“H5F_ACC_RDWR”,“H5P_DEFAULT”);g2id = H5G.open (fid,“两国集团”);H5L.move (fid检测器,“g3”g2id,“g3”,“H5P_DEFAULT”,“H5P_DEFAULT”);H5G.close (g2id);H5F.close (fid);

版本历史

之前介绍过的R2006a