Page tree

 

JAVA

FORTRAN

C++

C

 

Link

HP5_GET_CACHE

Queries the raw data chunk cache parameters

Procedure:

H5P_GET_CACHE ( plist_id,  mdc_nelmts, rdcc_nelmts, rdcc_nbytes, rdcc_w0 )

Signature:

herr_t H5Pget_cache(hid_t plist_id,
        int *mdc_nelmts,
        size_t *rdcc_nelmts,
        size_t *rdcc_nbytes,
        double *rdcc_w0
    )
  

Fortran90 Interface: h5pget_cache_f
    
SUBROUTINE h5pget_cache_f(prp_id, mdc_nelmts, rdcc_nelmts, rdcc_nbytes,
                          rdcc_w0, hdferr)
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN) :: prp_id         ! Property list identifier
  INTEGER, INTENT(OUT) :: mdc_nelmts           ! Number of elements (objects)
                                               ! in the meta data cache
  INTEGER(SIZE_T), INTENT(OUT) :: rdcc_nelmts  ! Number of elements (objects)
                                               ! in the meta data cache
  INTEGER(SIZE_T), INTENT(OUT) :: rdcc_nbytes  ! Total size of the raw data
                                               ! chunk cache, in bytes
  REAL, INTENT(OUT) :: rdcc_w0                 ! Preemption policy
  INTEGER, INTENT(OUT) :: hdferr               ! Error code
                                               ! 0 on success and -1 on failure
END SUBROUTINE h5pget_cache_f
	

Parameters:
hid_t plist_idIN: Identifier of the file access property list
int *mdc_nelmtsIN/OUT: No longer used
size_t *rdcc_nelmtsIN/OUT: Number of elements (objects) in the raw data chunk cache
size_t *rdcc_nbytes    IN/OUT: Total size of the raw data chunk cache, in bytes
double *rdcc_w0IN/OUT: Preemption policy

Description:

H5Pget_cache retrieves the maximum possible number of elements in the raw data chunk cache, the maximum possible number of bytes in the raw data chunk cache, and the preemption policy value.

Any (or all) arguments may be null pointers, in which case the corresponding datum is not returned.

Note that the *mdc_nelmts parameter is no longer used.

Returns:

Returns a non-negative value if successful; otherwise returns a negative value.

Example:

Coming Soon!

History:
Release    C
1.8.0Use of the mdc_nelmts parameter discontinued.
Metadata cache configuration is managed with H5Pset_mdc_config and H5Pget_mdc_config.
1.6.0The rdcc_nbytes and rdcc_nelmts parameters changed from type int to size_t.

--- Last Modified: December 04, 2017 | 08:55 AM