Skip Navigation Links.

H5G..::..create Method (H5LocId, , H5PropertyListId, H5PropertyListId, H5PropertyListId)

Create a HDF5 group. Creates a new empty group and gives it a name. http://www.hdfgroup.org/HDF5/doc/RM/RM_H5G.html#Group-Create

Namespace:  HDF5DotNet
Assembly:  HDF5DotNet (in HDF5DotNet.dll)

Syntax

Visual Basic
Public Shared Function create ( _
	groupOrFileId As H5LocId, _
	groupName As String, _
	linkCreation As H5PropertyListId, _
	groupCreation As H5PropertyListId, _
	groupAccess As H5PropertyListId _
) As H5GroupId
C#
public static H5GroupId create(
	H5LocId groupOrFileId,
	string groupName,
	H5PropertyListId linkCreation,
	H5PropertyListId groupCreation,
	H5PropertyListId groupAccess
)
Visual C++
public:
static H5GroupId^ create(
	H5LocId^ groupOrFileId, 
	String^ groupName, 
	H5PropertyListId^ linkCreation, 
	H5PropertyListId^ groupCreation, 
	H5PropertyListId^ groupAccess
)
JavaScript
HDF5DotNet.H5G.create = function(groupOrFileId, groupName, linkCreation, groupCreation, groupAccess);

Parameters

groupOrFileId
Type: HDF5DotNet..::..H5LocId
IN: provides a group or file id.
groupName
Type: String
IN: Absolute or relative name of the new group.
linkCreation
Type: HDF5DotNet..::..H5PropertyListId
groupCreation
Type: HDF5DotNet..::..H5PropertyListId
groupAccess
Type: HDF5DotNet..::..H5PropertyListId

Return Value

Returns a valid group identifier

Remarks

H5G.create creates a new group with the specified name at the specified location, loc_id. The location is identified by a file or group identifier. The name must not already be taken by some other object and all parent groups must already exist.

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.

Exceptions

ExceptionCondition
throws H5GcreateException if the creation fails.

See Also