Creates a new empty group and links it to a location in the file
Procedure:
H5G_CREATE1(loc_id, name, size_hint)
Signature:
hid_t H5Gcreate1( hid_t loc_id, const char *name, size_t size_hint )
SUBROUTINE h5gcreate_f(loc_id, name, grp_id, hdferr, &
size_hint, lcpl_id, gcpl_id, gapl_id)
IMPLICIT NONE
INTEGER(HID_T), INTENT(IN) :: loc_id ! File or group identifier
CHARACTER(LEN=*), INTENT(IN) :: name ! Name of the group
INTEGER(HID_T), INTENT(OUT) :: grp_id ! Group identifier
INTEGER, INTENT(OUT) :: hdferr ! Error code
! 0 on success and -1 on failure
INTEGER(SIZE_T), OPTIONAL, INTENT(IN) :: size_hint
! Parameter indicating the number of
! bytes to reserve for the names that
! will appear in the group.
! Note, set to OBJECT_NAMELEN_DEFAULT_F
! if using any of the optional
! parameters lcpl_id, gcpl_id,
! and/or gapl_id when not
! using keywords in specifying the
! optional parameters.
INTEGER(HID_T), OPTIONAL, INTENT(IN) :: lcpl_id
! Property list for link creation
INTEGER(HID_T), OPTIONAL, INTENT(IN) :: gcpl_id
! Property list for group creation
INTEGER(HID_T), OPTIONAL, INTENT(IN) :: gapl_id
! Property list for group access
END SUBROUTINE h5gcreate_f
Parameters:
hid_t loc_id | IN: Location identifier; may be a file, group, dataset, named datatype or attribute |
const char *name | IN: Absolute or relative name of the new group |
size_t size_hint | IN: Optional parameter indicating the number of bytes to reserve for the names that will appear in the group A conservative estimate could result in multiple system-level I/O requests to read the group name heap; a liberal estimate could result in a single large I/O request even when the group has just a few names. HDF5 stores each name with a null terminator. |
Description:
H5G_CREATE1 creates a new group with the specified name at the specified location, loc_id
. loc_id
may be a file, group, dataset, named datatype or attribute. If an attribute, dataset, or named datatype is specified for loc_id
then the group will be created at the location where the attribute, dataset, or named datatype is attached. The name, name
, must not already be taken by some other object and all parent groups must already exist.
name
can be a relative path based at loc_id
or an absolute path from the root of the file. Use of this function requires that any intermediate groups specified in the path already exist.
The length of a group name, or of the name of any object within a group, is not limited.
size_hint
is a hint for the number of bytes to reserve to store the names which will be eventually added to the new group. This value must be between 0 and UINT32_MAX (inclusive). If this parameter is zero, a default value will be used.
The return value is a group identifier for the open group. This group identifier should be closed by calling H5G_CLOSE when it is no longer needed.
See H5G_CREATE_ANON for a discussion of the differences between H5G_CREATE1 and H5G_CREATE_ANON.
Returns:
Returns a group identifier if successful; otherwise returns H5I_INVALID_HID.
Example:
Include Bitbucket Server for Confluence: File content cannot be shown
Unauthenticated access to this resource is not allowed. Please login to Confluence first.
History:
Release | Change |
---|
1.8.0 | Function H5Gcreate renamed to H5Gcreate1 and deprecated in this release. |
1.4.0 | Fortran call introduced in this release. |
1.0.0 | C function introduced in this release. |
--- Last Modified: May 11, 2021 | 10:53 AM