Last modified: 22 April 2016
Name: H5Sget_regular_hyperslab
Signature:
  `herr_t H5Sget_regular_hyperslab( hid_t space_id, hsize_t start[], hsize_t stride[], hsize_t count[], hsize_t block[] )`
Purpose:
  Retrieves a regular hyperslab selection.
Description:
  `H5Sget_regular_hyperslab` takes the dataspace identifier, `space_id`, and retrieves the values of `start`, `stride`, `count`, and `block` for the regular hyperslab selection.

  A regular hyperslab selection is a hyperslab selection described by setting the `offset`, `stride`, `count`, and `block` parameters to the `H5Sselect_hyperslab` call. If several calls to `H5Sselect_hyperslab` are needed, the hyperslab selection is irregular.

  See `H5Sselect_hyperslab` for descriptions of `offset`, `stride`, `count`, and `block`.

Note:
  If a hyperslab selection is originally regular, then becomes irregular through selection operations, and then becomes regular again, the final regular selection may be equivalent but not identical to the original regular selection.
Parameters:

  `hid_t space_id` | `` | IN: The identifier of the dataspace.
  `hsize_t start[]` | `` | OUT: Offset of the start of the regular hyperslab.
  `hsize_t stride[]` | `` | OUT: Stride of the regular hyperslab.
  `hsize_t count[]` | `` | OUT: Number of blocks in the regular hyperslab.
  `hsize_t block[]` | `` | OUT: Size of a block in the regular hyperslab.

Returns:
  Returns a non-negative value if successful; otherwise returns a negative value.
Fortran Interface: h5sget_regular_hyperslab_f
See Also:
  H5Sis_regular_hyperslab
  H5Sselect_hyperslab
  Virtual datasets: H5Pset_virtual
History:

  Release | Change
  1.10.0 | C function introduced with this release.