H5Pset_fapl_family (
hid_t fapl_id,
hsize_t memb_size,
hid_t memb_fapl_id
)
H5Pset_fapl_family sets the file access property list
identifier, fapl_id, to use the family driver.
memb_size is the size in bytes of each file member. Because
this size is not saved in the file, it is used both for creating a new
file, for re-opening and for extending an existing file.
When re-opening an existing family file, if there is only one member file,
the library allows this memb_size to be bigger than or equal to
the size of existing member file; if there are more than one member file,
the library sets the memb_size to be equal to the size of first
existing member file internally. In either case, no memb_size
smaller than the size of existing member file is allowed. If this happens,
the library will adjust the memb_size to the first existing
member file size internally instead of returning error.
For example, if the total file size is 1MB and the only existing member
file size is 1MB, memb_size can be bigger than or equal to
1MB. If the first member file size is 0.6MB and the second one is 0.4MB,
the library will set memb_size to 0.6MB internally no matter
what value the user passes in.
memb_fapl_id is the identifier of the
file access property list to be used for each family member.
hid_t fapl_id |
IN: File access property list identifier. |
hsize_t memb_size |
IN: Size in bytes of each file member. |
hid_t memb_fapl_id |
IN: Identifier of file access property list for each family member. |
SUBROUTINE h5pset_fapl_family_f(prp_id, imemb_size, memb_plist, hdferr)
IMPLICIT NONE
INTEGER(HID_T), INTENT(IN) :: prp_id ! Property list identifier
INTEGER(HSIZE_T), INTENT(IN) :: memb_size ! Logical size, in bytes,
! of each family member
INTEGER(HID_T), INTENT(IN) :: memb_plist ! Identifier of the file
! access property list to be
! used for each family member
INTEGER, INTENT(OUT) :: hdferr ! Error code
! 0 on success and -1 on failure
END SUBROUTINE h5pset_fapl_family_f
| Release | C |
| 1.4.0 | Function introduced in this release. |