Returns a file creation property list identifier
Procedure:
H5F_GET_CREATE_PLIST(file_id)
Signature:
hid_t H5Fget_create_plist(hid_t file_id )
SUBROUTINE h5fget_create_plist_f(file_id, fcpl_id, hdferr)
IMPLICIT NONE
INTEGER(HID_T), INTENT(IN) :: file_id ! File identifier
INTEGER(HID_T), INTENT(OUT) :: fcpl_id ! File creation property list
! identifier
INTEGER, INTENT(OUT) :: hdferr ! Error code
! 0 on success and -1 on failure
END SUBROUTINE h5fget_create_plist_f
Parameters:
hid_t file_id | IN: File identifier |
Description:
H5F_GET_CREATE_PLIST returns a file creation property list identifier identifying the creation properties used to create this file. This function is useful for duplicating properties when creating another file.
See “File Creation Properties” in H5P: Property List Interface in this reference manual and “File Creation Properties” in “The HDF5 File” chapter in the HDF5 User’s Guide for more information.
The creation property list identifier should be released with H5P_CLOSE.
Returns:
Returns a file creation property list identifier if successful; otherwise returns a negative value.
Example:
Example code is shown below. These excerpts are from the HDF5 source code tests:
C (see tfile.c):
tmpl1 = H5Fget_create_plist(fid1);
FORTRAN (see tH5F.F90):
CALL h5fget_create_plist_f(file1_id, prop_id, error)
--- Last Modified: May 24, 2018 | 04:26 PM