H5P_GET_CREATE_INTERMEDIATE_GROUP
Determines whether property is set to enable creating missing intermediate groups
H5P_GET_CREATE_INTERMEDIATE_GROUP ( lcpl_id, crt_intermed_group )
herr_t H5Pget_create_intermediate_group(
hid_t lcpl_id,
unsigned *crt_intermed_group
)
hid_t lcpl_id | IN: Link creation property list identifier |
unsigned *crt_intermed_group | OUT: Flag specifying whether to create intermediate groups upon creation of an object |
H5P_GET_CREATE_INTERMEDIATE_GROUP determines whether the link creation property list lcpl_id
is set to allow functions that create objects in groups different from the current working group to create intermediate groups that may be missing in the path of a new or moved object.
Functions that create objects in or move objects to a group other than the current working group make use of this property. H5G_CREATE_ANON and H5L_MOVE are examples of such functions.
If crt_intermed_group
is true, missing intermediate groups will be created; if crt_intermed_group
is false, missing intermediate groups will not be created.
Returns a non-negative value if successful; otherwise returns a negative value.
History:
Release | Change |
---|
1.8.0 | Function introduced in this release. |
--- Last Modified: August 06, 2019 | 01:57 PM