H5Freopen
(hid_t file_id
)
H5Freopen
returns a new file identifier for an
already-open HDF5 file, as specified by file_id
.
Both identifiers share caches and other information.
The only difference between the identifiers is that the
new identifier is not mounted anywhere and no files are
mounted on it.
Note that there is no circumstance under which
H5Freopen
can actually open a closed file;
the file must already be open and have an active
file_id
. E.g., one cannot close a file with
H5Fclose (file_id)
then use
H5Freopen (file_id)
to reopen it.
The new file identifier should be closed by calling
H5Fclose
when it is no longer needed.
hid_t file_id |
IN: Identifier of a file for which an additional identifier is required. |
SUBROUTINE h5freopen_f(file_id, new_file_id, hdferr) IMPLICIT NONE INTEGER(HID_T), INTENT(IN) :: file_id ! File identifier INTEGER(HID_T), INTENT(OUT) :: new_file_id ! New file identifier INTEGER, INTENT(OUT) :: hdferr ! Error code ! 0 on success and -1 on failure END SUBROUTINE h5freopen_f