Name: H5Pset_preserve
Signature:
herr_t H5Pset_preserve(hid_t plist, hbool_t status )
Purpose:
Sets the dataset transfer property list status to 1 (TRUE) or 0 (FALSE).

Notice:
This function is deprecated as it no longer has any effect; compound datatype field preservation is now core functionality in the HDF5 Library.

Description:
H5Pset_preserve sets the dataset transfer property list status to 1 (TRUE) or 0 (FALSE).

When reading or writing compound datatypes and the destination is partially initialized and the read/write is intended to initialize the other members, one must set this property to TRUE. Otherwise the I/O pipeline treats the destination datapoints as completely uninitialized.

Parameters:
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Fortran90 Interface: h5pset_preserve_f
SUBROUTINE h5pset_preserve_f(prp_id, flag, hdferr) 
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN) :: prp_id   ! Dataset transfer property 
                                         ! list identifier 
  LOGICAL, INTENT(IN)        :: flag     ! Status for the dataset 
                                         ! transfer property list 
  INTEGER, INTENT(OUT)       :: hdferr   ! Error code
                                         ! 0 on success and -1 on failure
END SUBROUTINE h5pset_preserve_f
	
History: