Name: H5Pget_char_encoding
Signature:
herr_t H5Pget_char_encoding( hid_t plist_id, H5T_cset_t encoding )

Purpose:
Retrieves the character encoding used to create a string.

Description:
H5Pget_char_encoding retrieves the character encoding used to encode strings or object names that are created with the property list plist_id.

Valid values for encoding are defined in H5Tpublic.h and include the following:
     H5T_CSET_ASCII US ASCII
     H5T_CSET_UTF8     UTF-8 Unicode encoding

Parameters:
hid_t plist_id IN: Property list identifier
H5T_cset_t encoding     OUT: String encoding character set

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

Fortran90 Interface: h5pget_char_encoding_f
SUBROUTINE h5pget_char_encoding_f(plist_id, encoding, hdferr)
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN) :: plist_id 
                                   ! Property list identifier
  INTEGER, INTENT(OUT) :: encoding ! Valid values for encoding are:
                                   !  H5T_CSET_ASCII_F -> US ASCII
                                   !  H5T_CSET_UTF8_F -> UTF-8 Unicode encoding
  INTEGER, INTENT(OUT) :: hdferr   ! Error code:
                                   ! 0 on success and -1 on failure
END SUBROUTINE h5pget_char_encoding_f
        

History:
Release     C
1.8.0 Function introduced in this release.