Last modified: 11 May 2011
Name: H5Pget_create_intermediate_group
Signature:
herr_t H5Pget_create_intermediate_group( hid_t lcpl_id, unsigned *crt_intermed_group )

Purpose:
Determines whether property is set to enable creating missing intermediate groups.

Description:
H5Pget_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. H5Gcreate_anon and H5Lmove 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.

Parameters:
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

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

Fortran90 Interface:
None.

History:
Release     C
1.8.0 Function introduced in this release.