H5Acreate2
(
hid_t loc_id
,
const char *attr_name
,
hid_t type_id
,
hid_t space_id
,
hid_t acpl_id
,
hid_t aapl_id
,
)
H5Acreate2
creates an attribute, attr_name
,
which is attached to the object specified by the identifier
loc_id
.
The attribute name, attr_name
, must be unique for
the object.
The attribute is created with the specified datatype and dataspace,
type_id
and space_id
,
which are created with the H5T and H5S interfaces, respectively.
If type_id
is either a fixed-length or
variable-length string, it is important to set the string length
when defining the datatype.
String datatypes are derived from H5T_C_S1
(or H5T_FORTRAN_S1
for Fortran codes),
which defaults to 1 character in size.
See H5Tset_size
and
“Creating
variable-length string datatypes.”
The access property list is currently unused, but will be used in the future.
This property list should currently be H5P_DEFAULT
.
The attribute identifier returned by this function must be released
with H5Aclose
or resource leaks will develop.
hid_t loc_id
|
IN: Location or object identifier
May be any HDF5 object identifier (group, dataset, or committed datatype) or an HDF5 file identifier; if loc_id is a file identifer, the attribute
will be attached to that file’s root group.
|
const char *attr_name
|
IN: Attribute name |
hid_t type_id
|
IN: Attribute datatype identifier |
hid_t space_id
|
IN: Attribute dataspace identifier |
hid_t acpl_id
|
IN: Attribute creation property list identifier
(Currently not used; specify H5P_DEFAULT .)
|
hid_t aapl_id
|
IN: Attribute access property list identifier
(Currently not used; specify H5P_DEFAULT .)
|
H5Acreate
.
H5Tset_size
Release | Change |
1.8.0 | C function introduced in this release. |