If the sizes specified in size are smaller than the dataset’s current dimension sizes, H5D_SET_EXTENT will reduce the dataset’s dimension sizes to the specified values. It is the user application’s responsibility to ensure that valuable data is not lost as H5D_SET_EXTENTdoes not check.
Except for external datasets, H5D_SET_EXTENTis for use with chunked datasets only, not contiguous datasets.
If a dataset is open for either writing or reading data when H5D_SET_EXTENT is called, the dataset’s dataspace must be refreshed before more data is written to the dataset and should be refreshed before any further data is read. This can be accomplished with a call to H5D_GET_SPACE.
Returns a non-negative value if successful; otherwise returns a negative value.
Function implemented but not supported in this release.