このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
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'
データセットへの属性の書き込み
double の配列を作成し、それをデータセット /g4/world
に書き込みます。
attData = [0 1 2 3]; h5writeatt('examplefile.h5','/g4/world','val2',attData);
データセットのメタデータを表示します。属性 val2
にはデータセットに属している属性のうちの 1 つがリストされます。
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
— ファイル名
文字ベクトル | string スカラー
ファイル名。既存の HDF5 ファイルの名前を含む文字ベクトルまたは string スカラーとして指定します。
書き込み先の場所によって、filename
は次のいずれかの形式にできます。
場所 | 形式 | ||||||
---|---|---|---|---|---|---|---|
現在のフォルダー | 現在のフォルダーに書き込むには、ファイルの名前を 例: | ||||||
その他のフォルダー | 現在のフォルダーとは異なるフォルダーに書き込むには、絶対パス名または相対パス名を 例: 例: | ||||||
リモートの場所 | リモートの場所に書き込むには、
リモートの場所に基づいて、
詳細については、リモート データの操作を参照してください。 例: |
loc
— ファイル内の位置
文字ベクトル | string スカラー
ファイル内の位置。属性を関連付ける既存のグループまたはデータセットの絶対パス名が含まれる文字ベクトルまたは string スカラーとして指定します。
attr
— 属性の名前
文字ベクトル | string スカラー
属性の名前。グループまたはデータセットに属している属性の名前が含まれる文字ベクトルまたは string スカラーとして指定します。属性が存在しない場合、 h5writeatt
は、指定した名前で属性を作成します。
指定した属性が既に存在するが、val
とデータ型またはデータ領域が一致しない場合、h5writeatt
はその属性を削除し、作成し直します。文字列属性は、単一の 0 次元データ点であるスカラー データ領域で作成されます。
val
— 属性の値
文字ベクトル | string 配列 | 数値
書き込まれる属性の値。文字ベクトル、string スカラー、または数値として指定します。
encoding
— テキスト エンコード
'UTF-8'
(既定値) | 'system'
テキスト エンコード。'TextEncoding'
と次の値のいずれかで構成されるコンマ区切りのペアとして指定します。
'UTF-8'
— UTF-8 エンコードを使用して文字を表す。'system'
— システム エンコードを使用して文字をバイトとして表す (非推奨)。
制限
h5writeatt
は、HDFS™ にリモートに保存されているファイルへの書き込みをサポートしません。
バージョン履歴
R2011a で導入R2020b: リモートの場所にある HDF5 ファイルへの属性の書き込み
Amazon S3、Windows Azure Blob Storage、HDFS などのリモートの場所にある HDF5 ファイルに属性を書き込むことができます。
R2020b: Unicode の名前をもつ HDF5 ファイルへの属性の書き込み
Unicode 文字としてエンコードされた名前をもつ HDF5 ファイルに属性を書き込むことができます。
R2020a: UTF-8 文字エンコードが既定の設定
すべての Unicode コード ポイントを HDF5 ファイル内で表現できるようにするために、現在は UTF-8 が h5writeatt
の既定の文字エンコードになっています。以前は、既定のエンコードは 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)