Name: H5Pset_fapl_core
Signature:
herr_t H5Pset_fapl_core( hid_t fapl_id, size_t increment, hbool_t backing_store )
Purpose:
Modifies the file access property list to use the H5FD_CORE driver.
Description:
H5Pset_fapl_core modifies the file access property list to use the H5FD_CORE driver.

The H5FD_CORE driver enables an application to work with a file in memory, speeding reads and writes as no disk access is made. File contents are stored only in memory until the file is closed. The backing_store parameter determines whether file contents are ever written to disk.

increment specifies the increment by which allocated memory is to be increased each time more memory is required.

If backing_store is set to 1 (TRUE), the file contents are flushed to a file with the same name as this core file when the file is closed or access to the file is terminated in memory.

Note:
There is currently no means for reading a file from disk then using the H5FD_CORE driver to manipulate the file.
Parameters:
Returns:
Returns a non-negative value if successful. Otherwise returns a negative value.
Fortran90 Interface: h5pset_fapl_core_f
SUBROUTINE h5pset_fapl_core_f(prp_id, increment, backing_store, hdferr) 
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN)  :: prp_id    ! Property list identifier
  INTEGER(SIZE_T), INTENT(IN) :: increment ! File block size in bytes
  LOGICAL, INTENT(IN) :: backing_store     ! Flag to indicate that entire 
                                           ! file contents are flushed to 
                                           ! a file with the same name as 
                                           ! this core file
  INTEGER, INTENT(OUT) :: hdferr           ! Error code
                                           ! 0 on success and -1 on failure
END SUBROUTINE h5pset_fapl_core_f
	
History: