Retrieves an identifier for the file containing the specified object
hid_t H5Iget_file_id( hid_t obj_id )
SUBROUTINE h5iget_file_id_f(obj_id, file_id, hdferr)
INTEGER(HID_T), INTENT(IN) :: obj_id ! Object identifier
INTEGER(HID_T), INTENT(OUT) :: file_id ! File identifier
INTEGER, INTENT(OUT) :: hdferr ! Error code
END SUBROUTINE h5iget_file_id_f
|IN: Identifier of the object whose associated file identifier will be returned; can be a file, group, dataset, named datatype or attribute identifier|
H5I_GET_FILE_ID returns the identifier of the file associated with the object referenced by
Note that the HDF5 library permits an application to close a file while objects within the file remain open. If the file containing the object
obj_id is still open, H5I_GET_FILE_ID will retrieve the existing file identifier. If there is no existing file identifier for the file, i.e., the file has been closed, H5I_GET_FILE_ID will reopen the file and return a new file identifier. In either case, the file identifier must eventually be released using H5F_CLOSE.
Returns a file identifier on success, negative on failure.
|1.6.3||Function introduced in this release.|
Fortran subroutine introduced in this release.
--- Last Modified: April 25, 2019 | 12:03 PM