Routines (alphabetical) > Routines: H > HDF5 Routines > H5S_SELECT_ELEMENTS

# H5S_SELECT_ELEMENTS

The H5S_SELECT_ELEMENTS procedure selects array elements to be included in the selection for a dataspace.

Note: Because of a bug in the underlying HDF5 library (from The HDF Group), you must specify the RESET keyword when using H5S_SELECT_ELEMENTS. Currently, there is no way to add to an existing selection, you can only replace the selection. If you do not specify /RESET then IDL will throw an error. This was done so that in a future IDL version when the HDF5 bug is fixed, your code will work as expected and you will not accidentally add to an existing selection instead of replacing the selection.

## Syntax

H5S_SELECT_ELEMENTS, Dataspace_id, Coordinates, /RESET

## Arguments

### Dataspace_id

An integer representing the dataspace’s identifier on which to set the selection.

### Coordinates

An m-element vector, or an (m x n) array, where m is the number of dimensions (or rank) of the dataspace, and n is the number of selected points. Each row contains the coordinates for an element selection point.

## Keywords

### RESET

Set this keyword to replace the existing selection with the new Coordinates. The default is RESET=0 which adds the new selection to the existing selection.

Note: As noted above, you must set the RESET keyword for the H5S_SELECT_ELEMENTS routine to work properly.

## Version History

5.6 | Introduced
8.3 | Add clarifying note about RESET keyword

## See Also

H5S_GET_SELECT_ELEM_NPOINTS, H5S_GET_SELECT_ELEM_POINTLIST, H5S_GET_SELECT_NPOINTS, H5S_SELECT_HYPERSLAB