H5Dset_extent
(
hid_t dset_id
,
const hsize_t size[]
)
H5Dset_extent
sets the current dimensions of the
chunked dataset dset_id
to the sizes specified in
size
.
size
is a 1-dimensional array with n elements,
where n is the rank of the dataset’s current dataspace.
This function can be applied to the following datasets:
maxdims
(see
H5Screate_simple
)
maxdims
Note that external datasets are always contiguous and can be extended only along the first dimension.
Space on disk is immediately allocated for the new dataset extent
if the dataset’s space allocation time is set to
H5D_ALLOC_TIME_EARLY
.
Fill values will be written to the dataset in either of the following situations, but not otherwise:
H5D_FILL_TIME_IFSET
and a fill value is defined
(see
H5Pset_fill_time
and
H5Pset_fill_value
)
H5D_FILL_TIME_ALLOC
(see
H5Pset_alloc_time
)
size
are smaller than
the dataset’s current dimension sizes,
H5Dset_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
H5Dset_extent
does not check.
H5Dset_extent
is for use
with chunked datasets only, not contiguous datasets.
H5Dset_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
H5Dget_space
.hid_t dset_id
|
IN: Dataset identifier |
const hsize_t size[]
|
IN: Array containing the new magnitude of each dimension of the dataset. |
SUBROUTINE h5dset_extent_f(dataset_id, size, hdferr) IMPLICIT NONE INTEGER(HID_T), INTENT(IN) :: dataset_id ! Dataset identifier INTEGER(HSIZE_T), DIMENSION(*), INTENT(IN) :: size ! Array containing ! dimensions’ sizes INTEGER, INTENT(OUT) :: hdferr ! Error code: ! 0 on success and -1 on failure END SUBROUTINE h5dset_extent_f
H5Pset_alloc_time
H5Pset_fill_time
H5Pset_fill_value
| |
H5Screate_simple
H5Dget_space
|
Release | Change |
1.6.0 | Function implemented but not supported in this release. |
1.8.0 | Function supported in this release. |