Signature:

  SUBROUTINE h5literate_by_name_f(loc_id, group_name, index_type, &
            order, idx, op, op_data, return_value, hdferr, lapl_id)
    INTEGER(HID_T), INTENT(IN) :: loc_id
    CHARACTER(LEN=*) :: group_name 
    INTEGER, INTENT(IN) :: index_type
    INTEGER, INTENT(IN) :: order
    INTEGER(HSIZE_T), INTENT(INOUT) :: idx

    TYPE(C_FUNPTR):: op  
    TYPE(C_PTR)   :: op_data

    INTEGER, INTENT(OUT) :: return_value

    INTEGER, INTENT(OUT) :: hdferr
    INTEGER(HID_T), OPTIONAL, INTENT(IN) :: lapl_id

Inputs:

  loc_id     - File or group identifier specifying location of subject group
  group_name - Name of 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

Optional parameters:

  lapl_id    - Link access property list