h5writeatt
写入 HDF5 属性
说明
示例
将属性写入根组
向 examplefile.h5
的根组写入一个属性,其值为当前时间。
date = datestr(now); h5writeatt('examplefile.h5','/','creation_date', date);
从 HDF5 文件的根组中读取该属性。
val1 = h5readatt('examplefile.h5','/','creation_date')
val1 = '19-Aug-2023 13:56:51'
将属性写入数据集
创建一个双精度数组,并将其写入数据集 /g4/world
。
attData = [0 1 2 3]; h5writeatt('examplefile.h5','/g4/world','val2',attData);
显示数据集元数据。列出的属性 val2
是属于数据集的属性之一。
h5disp('examplefile.h5','/g4/world');
HDF5 examplefile.h5 Dataset 'world' Size: 36x19 MaxSize: 36x19 Datatype: H5T_IEEE_F64LE (double) ChunkSize: [] Filters: none FillValue: 0.000000 Attributes: 'val2': 0.000000 1.000000 2.000000 3.000000
输入参数
filename
— 文件名
字符向量 | 字符串标量
文件名,指定为包含现有 HDF5 文件名称的字符向量或字符串标量。
根据您写入的位置,filename
可以采用以下形式之一。
位置 | 形式 | ||||||
---|---|---|---|---|---|---|---|
当前文件夹 | 要写入当前文件夹,请在 示例: | ||||||
其他文件夹 | 要写入不同于当前文件夹的文件夹,请在 示例: 示例: | ||||||
远程位置 | 要写入远程位置,
根据您的远程位置,
有关详细信息,请参阅处理远程数据。 示例: |
loc
— 文件中的位置
字符向量 | 字符串标量
文件中的位置,指定为字符向量或字符串标量,其中包含要与该属性关联的现有组或数据集的完整路径名称。
attr
— 属性的名称
字符向量 | 字符串标量
属性的名称,指定为包含属于某组或数据集的属性名称的字符向量或字符串标量。如果该属性不存在,h5writeatt
使用指定的名称创建该属性。
如果指定的属性已存在但不具有与 val
一致的数据类型或数据空间,则 h5writeatt
将删除该属性并重新创建它。字符串属性是使用一个标量数据空间创建的,标量数据空间是单一的零维数据点。
val
— 属性的值
字符向量 | 字符串数组 | 数值
要写入的属性的值,指定为字符向量、字符串标量或数值。
encoding
— 文本编码
'UTF-8'
(默认) | 'system'
文本编码,指定为以逗号分隔的对组,其中包含 'TextEncoding'
和下列值之一:
'UTF-8'
- 使用 UTF-8 编码表示字符。'system'
- 使用系统编码将字符表示为字节(不推荐)。
局限性
h5writeatt
不支持在 HDFS™ 远程位置写入文件。
版本历史记录
在 R2011a 中推出R2020b: 将属性写入远程位置的 HDF5 文件
您可以将属性写入远程位置(例如 Amazon S3、Windows Azure Blob 存储和 HDFS)的 HDF5 文件。
R2020b: 将属性写入具有 Unicode 名称的 HDF5 文件
您可以将属性写入其名称以 Unicode 字符编码的 HDF5 文件。
R2020a: UTF-8 字符编码是默认设置
UTF-8 现在是 h5writeatt
的默认字符编码,因此所有 Unicode 代码点都能在 HDF5 文件中表示。以前,默认编码是 ASCII。
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)