H5Sselect_elements
(hid_t space_id
,
H5S_seloper_t op
,
size_t num_elements
,
const hsize_t *coord
)
H5Sselect_elements
selects array elements to be
included in the selection for the space_id
dataspace.
The number of elements selected is set in the
num_elements
parameter.
The coord
array is a two-dimensional array of size
num_elements
by dataspace_rank
containing a list of of zero-based values specifying the
coordinates in the dataset of the selected elements.
The order of the element coordinates in the
coord
array specifies the order in which
the array elements are iterated through when I/O is performed.
Duplicate coordinate locations are not checked for.
The selection operator op
determines how the
new selection is to be combined with the previously 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. Adds the new selection to the existing selection. |
H5S_SELECT_APPEND
| Adds the new selection following the last element of the existing selection. |
H5S_SELECT_PREPEND
| Adds the new selection preceding the first element of the existing selection. |
hid_t space_id |
Identifier of the dataspace. |
H5S_seloper_t op |
Operator specifying how the new selection is to be combined with the existing selection for the dataspace. |
size_t num_elements |
Number of elements to be selected. |
const hsize_t *coord |
A 2-dimensional array of 0-based values specifying the coordinates of the elements being selected. |
SUBROUTINE h5sselect_elements_f(space_id, operator, rank, num_elements, coord, hdferr) IMPLICIT NONE INTEGER(HID_T), INTENT(IN) :: space_id ! Dataspace identifier INTEGER, INTENT(IN) :: operator ! Flag, valid values are: ! H5S_SELECT_SET_F ! H5S_SELECT_APPEND_F ! H5S_SELECT_PREPEND_F INTEGER, INTENT(IN) :: rank ! Number of dataspace ! dimensions
INTEGER(SIZE_T), INTENT(IN) :: num_elements ! Number of elements to be ! selected INTEGER(HSIZE_T), DIMENSION(*,*), INTENT(IN) :: coord ! A 1-based array containing the ! coordinates of the selected ! elements ! NOTE: Reversed dimension declaration ! compared to the C specification ! of coord(num_elements, rank) INTEGER, INTENT(OUT) :: hdferr ! Error code ! 0 on success and -1 on failure END SUBROUTINE h5sselect_elements_f
Release | C | Fortran90 | |
1.6.4 |
coord parameter type changed to
const hsize_t. |
coord parameter type changed to
INTEGER(HSIZE_T) . |