H5S_GET_SIMPLE_EXTENT_DIMS
Retrieves dataspace dimension size and maximum size
Procedure:
H5S_GET_SIMPLE_EXTENT_DIMS ( space_id, dims, maxdims )
Signature:
int H5Sget_simple_extent_dims(hid_t space_id,
hsize_t *dims,
hsize_t *maxdims
)
Fortran90 Interface: h5sget_simple_extent_dims_f
SUBROUTINE h5sget_simple_extent_dims_f(space_id, dims, maxdims, hdferr)
IMPLICIT NONE
INTEGER(HID_T), INTENT(IN) :: space_id ! Dataspace identifier
INTEGER(HSIZE_T), DIMENSION(*), INTENT(OUT) :: dims
! Array to store dimension sizes
INTEGER(HSIZE_T), DIMENSION(*), INTENT(OUT) :: maxdims
! Array to store max dimension sizes
INTEGER, INTENT(OUT) :: hdferr ! Error code
! Dataspace rank on success
! and -1 on failure
END SUBROUTINE h5sget_simple_extent_dims_f
Parameters:
hid_t space_id | IN: Identifier of the dataspace object to query |
hsize_t *dims | OUT: Pointer to array to store the size of each dimension |
hsize_t *maxdims | OUT: Pointer to array to store the maximum size of each dimension |
Description:
H5S_GET_SIMPLE_EXTENT_DIMS returns the size and maximum sizes of each dimension of a dataspace space_id
through the dims
and maxdims
parameters.
Either or both of dims
and maxdims
may be NULL.
If a value in the returned array maxdims
is H5S_UNLIMITED (-1), the maximum size of that dimension is unlimited.
Returns:
Returns the number of dimensions in the dataspace if successful; otherwise returns a negative value.
Example:
space = H5Dget_space (dset);
ndims = H5Sget_simple_extent_dims (space, dims, NULL);
CALL h5dget_space_f(dset,space, hdferr)
CALL h5sget_simple_extent_dims_f(space, dims, maxdims, hdferr)
History:
--- Last Modified: May 03, 2019 | 02:02 PM