H5L_GET_VAL_IDX retrieves the value of the nth link in a group, according to the specified order,
order, within an index,
- For soft links, the value is the path name of the object pointed to.
- For external links, this is a compound value containing file and path name information; to use this external link information, it must first be decoded with H5L_UNPACK_ELINK_VAL
- For user-defined links, this value will be described in the definition of the user-defined link type.
- This function will fail if called on a hard link.
loc_id specifies the location identifier of the group specified by
group_name specifies the group in which the link exists. If
loc_id already specifies the group in which the link exists,
group_name must be a dot (.).
The size in bytes of
group_name is specified in
size is unknown, it can be determined via an initial H5L_GET_VAL_IDX call with
size set to
size will be returned with the actual size of
If the type of the link is unknown or uncertain, H5L_GET_VAL_IDX should be called only after the type has been determined via a call to H5L_GET_INFO_BY_IDX.