主要内容

本页翻译不是最新的。点击此处可查看最新英文版本。

h5readatt

从 HDF5 文件中读取属性

说明

attval = h5readatt(filename,loc,attr) 从 HDF5 文件中的指定位置检索指定属性的值。

示例

示例

全部折叠

从 HDF5 文件 example.h5 的根组中读取属性 attr2

val = h5readatt('example.h5','/','attr2')
val = 2×2 int32 matrix

   0   2
   1   3

从 HDF5 文件 example.h5 中的数据集 lon 中读取属性 units

val = h5readatt('example.h5','/g4/lon','units')
val = 
'degrees_east'

输入参数

全部折叠

现有 HDF5 文件的文件名,指定为字符串标量或字符向量。

根据文件的位置,filename 可以采用下列形式之一。

位置

形式

当前文件夹或 MATLAB® 路径上的文件夹

如果文件位于当前文件夹中或 MATLAB 路径上的文件夹中,则在 filename 中指定文件名。

示例:"myFile.h5"

其他文件夹

如果该文件既不在当前文件夹中,也不在 MATLAB 路径下的文件夹中,则在 filename 中指定完整或相对路径。

示例:"C:\myFolder\myFile.h5"

例如:"myFolder\myFile.h5"

统一资源定位器 (URL) (自 R2024b 起)

如果文件是通过 Internet URL 定位的,则 filename 必须包含协议类型,例如 http://。有关详细信息,请参阅处理远程数据

例如:"http://my_hostname/my_path/my_file.h5"

远程位置

如果文件存储在远程位置,则 filename 必须包含指定为统一资源定位器 (URL) 形式的文件的完整路径:

scheme_name://path_to_file/filename

根据您的远程位置,scheme_name 可以是下表中的值之一。

远程位置scheme_name
Amazon S3™s3
Windows Azure® Blob 存储wasb, wasbs
HDFS™hdfs

有关详细信息,请参阅处理远程数据

例如:"s3://myBucket/myFolder/myFile.h5"

  • 如果您的文件包含多个使用 Family 驱动的物理文件,请使用格式设定符指定 filename。如果这些物理文件不在您的当前文件夹中,则需使用完整或相对路径指定它们。例如,要将 Family 驱动用于您的当前文件夹中的两个文件 family0.h5family1.h5,请将 filename 指定为 "family%d.h5"

  • 如果您的文件包含多个使用 Multi 驱动或 Split 驱动的物理文件,请指定 filename 作为物理文件名的前缀。如果这些物理文件不在您的当前文件夹中,则需使用完整或相对路径指定它们。例如,要将 Multi 驱动用于您的当前文件夹中的六个文件 multi-b.h5multi-g.h5multi-l.h5multi-o.h5multi-r.h5multi-s.h5,请将 filename 指定为 "multi"

文件中的位置,指定为字符向量或字符串标量,其中包含属性所属的现有组或数据集的完整路径。要从文件的根组中读取属性,请指定 '/' 作为位置。

属性名称,指定为包含属于某组或数据集的属性名称的字符向量或字符串标量。

限制

  • MATLAB 不支持要求身份验证的 Internet URL。

  • MATLAB Online™ 支持与 Microsoft® OneDrive™ 文件和文件夹相关联的 Internet URL,而 MATLAB 的安装版本仅支持本地 OneDrive 文件。

  • h5readatt 函数对未通过文件完整性检查的属性和数据集报错。要在此类情况下读取属性,请使用 H5P.set_relax_file_integrity_checks 函数和低级 HDF5 接口。 (自 R2024b 起)

版本历史记录

在 R2011a 中推出

全部展开