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 attribute creation and access property lists are currently unused,
but will be used in the future for optional attribute creation
and access properties.
These property lists 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. |