Name: H5Sselect_elements
Signature:
  herr_t `H5Sselect_elements`(hid_t `space_id`, H5S_seloper_t `op`, size_t `num_elements`, const hsize_t *`coord` )
Purpose:
  Selects array elements to be included in the selection for a dataspace.
Description:
  `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.

Parameters:

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.

Returns:
  Returns a non-negative value if successful; otherwise returns a negative value.
Fortran90 Interface: h5sselect_elements_f

      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

History:

Release | C |  | Fortran90
1.6.4 | `coord` parameter type changed to const hsize_t. |  | `coord` parameter type changed to `INTEGER(HSIZE_T)`.