H5Pget_fill_value
(
hid_t plist_id
,
hid_t type_id
,
void *value
)
H5Pget_fill_value
returns the dataset
fill value defined in the dataset creation property list
plist_id
.
The fill value is returned through the value
pointer and will be converted to the datatype specified
by type_id
.
This datatype may differ from the
fill value datatype in the property list,
but the HDF5 library must be able to convert between the
two datatypes.
If the fill value is undefined,
i.e., set to NULL
in the property list,
H5Pget_fill_value
will return an error.
H5Pfill_value_defined
should be used to
check for this condition before
H5Pget_fill_value
is called.
Memory must be allocated by the calling application.
H5Pget_fill_value
is designed to coordinate
with the dataset storage allocation time and
fill value write time properties, which can be retrieved
with the functions H5Pget_alloc_time
and H5Pget_fill_time
, respectively.
hid_t plist_id |
IN: Dataset creation property list identifier. |
hid_t type_id , |
IN: Datatype identifier for the value passed
via value . |
void *value |
OUT: Pointer to buffer to contain the returned fill value. |
Release | Change |
1.8.8 | Fortran updated to Fortran2003. |