[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Selects a hyperslab region to add to the current selected region.

Syntax

Visual Basic (Declaration)
Public Shared Sub selectHyperslab ( _
	spaceId As H5DataSpaceId, _
	selectOperator As SelectOperator, _
	start As ULong(), _
	count As ULong(), _
	block As ULong() _
)
C#
public static void selectHyperslab (
	H5DataSpaceId spaceId,
	H5S.SelectOperator selectOperator,
	ulong[] start,
	ulong[] count,
	ulong[] block
)
C++
public:
static void selectHyperslab (
	H5DataSpaceId^ spaceId, 
	SelectOperator selectOperator, 
	array<unsigned long long>^ start, 
	array<unsigned long long>^ count, 
	array<unsigned long long>^ block
)

Parameters

spaceId (H5DataSpaceId)
IN: Identifier of dataspace selection to modify
selectOperator (SelectOperator)
IN: Operation to perform on current selection.
start (UInt64[]())
IN: Offset of start of hyperslab
count (UInt64[]())
IN: Number of blocks included in hyperslab.
block (UInt64[]())
IN: Size of block in hyperslab.

Remarks

H5S.selectStridedHyperslab selects a hyperslab region to add to the current selected region for the dataspace specified by space_id.

The start, count, and block arrays must be the same size as the rank of the dataspace.

The selection operator op determines how the new selection is to be combined with the already existing selection for the dataspace. The following operators are supported:

  • 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 start array determines the starting coordinates of the hyperslab to select.

The results of calling selectHyperslab are identical to calling selectStridedHyperslab, with stride values equal to 1.

The count array determines how many blocks to select from the dataspace, in each dimension.

The block array determines the size of the element block selected from the dataspace. If the block parameter is omitted, the block size defaults to a single element in each dimension (as if the block array were set to all 1's).

Regions selected with this function call default to C order iteration when I/O is performed.