*
* | #H5S_SELECT_SET |
* Replaces the existing selection with the
* parameters from this call. Overlapping blocks
* are not supported with this operator. |
*
*
* | #H5S_SELECT_OR |
* Adds the new selection to the existing selection.
* (Binary OR) |
*
*
* | #H5S_SELECT_AND |
* Retains only the overlapping portions of the
* new selection and the existing selection.
* (Binary AND) |
*
*
* | #H5S_SELECT_XOR |
* Retains only the elements that are members of
* the new selection or the existing selection,
* excluding elements that are members of both
* selections. (Binary exclusive-OR, XOR)
* |
*
*
* | #H5S_SELECT_NOTB |
* Retains only elements of the existing selection
* that are not in the new selection. |
*
*
* | #H5S_SELECT_NOTA |
* Retains only elements of the new selection that
* are not in the existing selection. |
*
*
*
* The \p start array specifies the offset of the starting element
* of the specified hyperslab.
*
* The \p stride array chooses array locations from the dataspace with
* each value in the \p stride array determining how many elements to
* move in each dimension. Setting a value in the \p stride array to
* \p 1 moves to each element in that dimension of the dataspace;
* setting a value of \p 2 in allocation in the \p stride array moves
* to every other element in that dimension of the dataspace. In
* other words, the \p stride determines the number of elements to
* move from the \p start location in each dimension. Stride values
* of \p 0 are not allowed. If the \p stride parameter is NULL, a
* contiguous hyperslab is selected (as if each value in the \p stride
* array were set to \p 1).
*
* The \p count array determines how many blocks to select from the
* dataspace, in each dimension.
*
* The \p block array determines the size of the element block
* selected from the dataspace. If the \p block parameter is set to
* NULL, the block size defaults to a single element in each dimension
* (as if each value in the \p block array were set to \p 1).
*
* For example, consider a 2-dimensional dataspace with hyperslab
* selection settings as follows: the \p start offset is specified as
* [1,1], \p stride is [4,4], \p count is [3,7], and \p block is [2,2].
* In C, these settings will specify a hyperslab consisting of 21
* 2x2 blocks of array elements starting with location (1,1) with the
* selected blocks at locations (1,1), (5,1), (9,1), (1,5), (5,5), etc.;
* in Fortran, they will specify a hyperslab consisting of 21 2x2
* blocks of array elements starting with location (2,2) with the
* selected blocks at locations (2,2), (6,2), (10,2), (2,6), (6,6), etc.
*
* Regions selected with this function call default to C order
* iteration when I/O is performed.
*
* \version 1.4.0 Fortran subroutine introduced in this release.
* \since 1.0.0
*
*/
H5_DLL herr_t H5Sselect_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[]);
/*--------------------------------------------------------------------------*/
/**\ingroup H5S
*
* \brief Resets the selection region to include no elements
*
* \space_id{spaceid}
*
* \return \herr_t
*
* \details H5Sselect_none() resets the selection region for the dataspace
* \p space_id to include no elements.
*
* \since 1.0.0
*
*/
H5_DLL herr_t H5Sselect_none(hid_t spaceid);
/*--------------------------------------------------------------------------*/
/**\ingroup H5S
*
* \brief Verifies that the selection is within the extent of the dataspace
*
* \space_id{spaceid}
*
* \return \htri_t
*
* \details H5Sselect_valid() verifies that the selection for the dataspace
* \p space_id is within the extent of the dataspace if the current
* offset for the dataspace is used.
*
* \version 1.4.0 Fortran subroutine introduced in this release.
* \since 1.0.0
*
*/
H5_DLL htri_t H5Sselect_valid(hid_t spaceid);
#ifdef __cplusplus
}
#endif
#endif /* H5Spublic_H */