Last modified: 20 March 2012
Name: H5Pset_attr_creation_order
Signature:
herr_t H5Pset_attr_creation_order( hid_t ocpl_id, unsigned crt_order_flags )

Purpose:
Sets tracking and indexing of attribute creation order.

Description:
H5Pset_attr_creation_order sets flags for tracking and indexing attribute creation order on an object.

ocpl_id is a dataset or group creation property list identifier. The term ocpl, for object creation property list, is used when more than one type of object may be involved.

crt_order_flags contains flags with the following meanings:
     H5P_CRT_ORDER_TRACKED Attribute creation order is tracked but not necessarily indexed.
     H5P_CRT_ORDER_INDEXED     Attribute creation order is indexed (requires H5P_CRT_ORDER_TRACKED).
Default behavior is that attribute creation order is neither tracked nor indexed.

H5Pset_attr_creation_order can be used to set attribute creation order tracking, or to set attribute creation order tracking and indexing.

Note that if a creation order index is to be built, it must be specified in the object creation property list. HDF5 currently provides no mechanism to turn on attribute creation order tracking at object creation time and to build the index later.

Parameters:
hid_t ocpl_id IN: Object creation property list identifier
unsigned crt_order_flags     IN: Flags specifying whether to track and index attribute creation order
Default: No flag set; attribute creation order is neither tracked not indexed.

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

Fortran90 Interface: h5pset_attr_creation_order_f
SUBROUTINE h5pset_attr_creation_order_f(ocpl_id, crt_order_flags , hdferr)
  IMPLICIT NONE 
  INTEGER(HID_T), INTENT(IN) :: ocpl_id   ! Object (dataset or group) creation 
                                          ! property list identifier
  INTEGER, INTENT(IN) :: crt_order_flags  ! Flags specifying whether to track 
                                          ! and index attribute creation order
  INTEGER, INTENT(OUT) :: hdferr          ! Error code 
                                          ! 0 on success and -1 on failure
END SUBROUTINE h5pset_attr_creation_order_f
    

History:
Release     C
1.8.0 Function introduced in this release.