Performs an operation on a hyperslab and an existing selection and returns the resulting selection

Procedure:

H5S_COMBINE_HYPERSLAB  ( space_id, op, start, stride, count, block)

Signature:

<pre><code class="language-c">hid_t  H5Scombine_hyperslab ( hid_t space_id, H5S_seloper_t op, const hsize_t start[],
                      const hsize_t stride[], const hsize_t count[], const hsize_t block[] )</code></pre>

<pre><code class="language-fortran">Replace this text with the Fortran function signature</code></pre>

Parameters:
hid_t space_idIN: Dataspace identifier of the selection to use
H5S_seloper_t opIN: Operation to perform on the current selection
const hsize_t start[]IN: Offset of the start of of the hyperslab
const hsize_t stride[]IN: Hyperslab stride
const hsize_t count[]IN: Number of blocks included in the hyperslab
const hsize_t block[]IN: Size of a block in the hyperslab

Description:

H5S_COMBINE_HYPERSLAB combines a hyperslab selection specified by start, stride, count and block with the current selection for the dataspace space_id, creating a new dataspace to return the generated selection.  If the current selection is not a hyperslab, it is freed and the hyperslab parameters passed in are combined with the H5S_SEL_ALL hyperslab (ie. a selection composing the entire current extent). If either stride or block is NULL, then it will be set to 1.

Returns:

Dataspace identifier on success / H5I_INVALID_HID on failure

Example:

History:
ReleaseChange
1.10.7, 1.12.0Function introduced in this release.