Modifies a filter in the filter pipeline
Procedure:
H5P_MODIFY_FILTER ( plist_id, filter_id, flags, cd_nelmts, cd_values )
Signature:
herr_t H5Pmodify_filter(
hid_t plist_id,
H5Z_filter_t filter_id,
unsigned int flags,
size_t cd_nelmts,
const unsigned int cd_values[]
)
Fortran90 Interface: h5pmodify_filter_f
SUBROUTINE h5pmodify_filter_f(prp_id, filter, flags, cd_nelmts, &
cd_values, hdferr)
IMPLICIT NONE
INTEGER(HID_T), INTENT(IN) :: prp_id ! Property list identifier
INTEGER, INTENT(IN) :: filter ! Filter to be modified
INTEGER, INTENT(IN) :: flags ! Bit vector specifying certain
! general properties of the filter
INTEGER(SIZE_T), INTENT(IN) :: cd_nelmts ! Number of elements in cd_values
INTEGER, DIMENSION(*), INTENT(IN) :: cd_values
! Auxiliary data for the filter
INTEGER, INTENT(OUT) :: hdferr ! Error code
! 0 on success and -1 on failure
END SUBROUTINE h5pmodify_filter_f
Parameters:
hid_t plist_id | IN: Dataset or group creation property list identifier |
H5Z_filter_t filter_id | IN: Filter to be modified |
unsigned int flags | IN: Bit vector specifying certain general properties of the filter |
size_t cd_nelmts | IN: Number of elements in cd_values |
const unsigned int cd_values[] | IN: Auxiliary data for the filter |
Description:
H5P_MODIFY_FILTER modifies the specified filter_id
in the filter pipeline. plist_id
must be a dataset or group creation property list.
The filter_id
, flags
cd_nelmts[]
, and cd_values
parameters are used in the same manner and accept the same values as described in the discussion of H5P_SET_FILTER.
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Example:
History:
Release | Change |
---|
1.6.0 | Function introduced in this release. |
1.8.5 | Function extended to work with group creation property lists. |
--- Last Modified: August 07, 2019 | 11:51 AM