Last modified: 16 November 2010
Name: H5Sset_extent_simple
Signature:
  herr_t `H5Sset_extent_simple`( hid_t `space_id`, int `rank`, const hsize_t *`current_size`, const hsize_t *`maximum_size` )

Purpose:
  Sets or resets the size of an existing dataspace.

Description:
  `H5Sset_extent_simple` sets or resets the size of an existing dataspace.

  `rank` is the dimensionality, or number of dimensions, of the dataspace.

  `current_size` is an array of size `rank` which contains the new size of each dimension in the dataspace. `maximum_size` is an array of size `rank` which contains the maximum size of each dimension in the dataspace.

  Any previous extent is removed from the dataspace, the dataspace type is set to `H5S_SIMPLE`, and the extent is set as specified.

  Note that a dataset must be chunked if `current_size` does not equal `maximum_size`.

Parameters:

  hid_t `space_id` | IN: Dataspace identifier.
  int `rank` | IN: Rank, or dimensionality, of the dataspace.
  const hsize_t *`current_size` | IN: Array containing current size of dataspace.
  const hsize_t *`maximum_size` | IN: Array containing maximum size of dataspace.

Returns:
  Returns a non-negative value if successful; otherwise returns a negative value.

Fortran90 Interface: h5sset_extent_simple_f

      SUBROUTINE h5sset_extent_simple_f(space_id, rank, current_size,
                                        maximum_size, hdferr)
        IMPLICIT NONE
        INTEGER(HID_T), INTENT(IN) :: space_id     ! Dataspace identifier
        INTEGER, INTENT(IN) :: rank                ! Dataspace rank
        INTEGER(HSIZE_T), DIMENSION(rank), INTENT(IN) :: current_size
                                                   ! Array with the new sizes
                                                   ! of dimensions
        INTEGER(HSIZE_T), DIMENSION(rank), INTENT(IN) ::
                                                   ! Array with the new maximum
                                                   ! sizes of dimensions
        INTEGER, INTENT(OUT) :: hdferr             ! Error code
                                                   ! 0 on success and -1 on failure
      END SUBROUTINE h5sset_extent_simple_f