H5S_COMBINE_HYPERSLAB

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:

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[] )

Parameters:

hid_t `space_id`	IN: Dataspace identifier of the selection to use
H5S_seloper_t `op`	IN: 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:

test / tselect.c [5199:5204] hdf5_1_12 HDFFV/hdf5

    hsize_t start_out[2] = {0, 3}; /* Hyperslab offset in memory */
    int     data[6][5];            /* Data to write */
    int     data_out[7][7];        /* Data read in */
    int     input_loc[8][2]  = {{0, 0}, {1, 0}, {2, 0}, {2, 1}, {3, 1}, {4, 1}, {4, 2}, {5, 2}};
    int     output_loc[8][2] = {{0, 3}, {0, 4}, {1, 3}, {1, 4}, {2, 3}, {2, 4}, {3, 3}, {3, 4}};
    int     dsetrank         = 2; /* File Dataset rank */

History:

Release	Change
1.10.7, 1.12.0	Function introduced in this release.

--- Last Modified: September 15, 2020 | 02:34 PM

Page tree

H5S_COMBINE_HYPERSLAB

Procedure:

Signature:

Parameters:

Description:

Returns:

Example:

History:

The HDF Group

Site

Resources

Connect