H5Pset_family_offset
(
hid_t fapl_id
,
hsize_t offset
)
H5Pset_family_offset
sets the offset property in the
file access property list fapl_id
so that the user application
can retrieve a file handle for low-level access to a particular member
of a family of files. The file handle is retrieved with a separate call
to H5Fget_vfd_handle
(or, in special circumstances, to H5FDget_vfd_handle
;
see Virtual File Layer and List of VFL Functions
in HDF5 Technical Notes).
The value of offset
is an offset in bytes from the
beginning of the HDF5 file, identifying a user-determined location
within the HDF5 file. The file handle the user application is seeking
is for the specific member-file in the associated family of files
to which this offset is mapped.
Use of this function is only appropriate for an HDF5 file written as a
family of files with the FAMILY
file driver.
hid_t fapl_id |
IN: File access property list identifier. |
hsize_t offset |
IN: Offset in bytes within the HDF5 file. |
SUBROUTINE h5pset_family_offset_f(prp_id, offset, hdferr) IMPLICIT NONE INTEGER(HID_T), INTENT(IN) :: prp_id ! Property list identifier INTEGER(HSIZE_T), INTENT(IN) :: offset ! Offset in bytes INTEGER, INTENT(OUT) :: hdferr ! Error code ! 0 on success and -1 on failure END SUBROUTINE h5pset_family_offset_f
Release | C |
1.6.0 | Function introduced in this release. |