SUBROUTINE h5literate_f(group_id, index_type, order, idx, &
op, op_data, return_value, hdferr)
INTEGER(HID_T) , INTENT(IN) :: group_id
INTEGER , INTENT(IN) :: index_type
INTEGER , INTENT(IN) :: order
INTEGER(HSIZE_T), INTENT(INOUT) :: idx
TYPE(C_FUNPTR) , INTENT(IN) :: op
TYPE(C_PTR) , INTENT(IN) :: op_data
INTEGER , INTENT(OUT) :: return_value
INTEGER , INTENT(OUT) :: hdferr
Inputs:
group_id - Identifier specifying subject group
index_type - Type of index which determines the order:
H5_INDEX_NAME_F - Alpha-numeric index on name
H5_INDEX_CRT_ORDER_F - Index on creation order
order - Order within index:
H5_ITER_INC_F - Increasing order
H5_ITER_DEC_F - Decreasing order
H5_ITER_NATIVE_F - Fastest available order
idx - IN: Iteration position at which to start
op - Callback function passing data regarding the link to the
calling application
op_data - User-defined pointer to data required by the application
for its processing of the link
Outputs:
idx - OUT: Position at which an interrupted iteration may
be restarted
return_value - Success: The return value of the first operator that
returns non-zero, or zero if all members were
processed with no operator returning non-zero.
Failure: Negative if something goes wrong within the
library, or the negative value returned by one
of the operators.
hdferr - Returns 0 if successful and -1 if fails