Creating Groups: h5newGroupΒΆ
h5newGroup creates a new HDF5 group.
Excel UDF Syntax
h5newGroup(filename, groupname)
Mandatory Arguments
Argument | Description |
---|---|
filename | A text string specifying the name of an HDF5 file. If the file doesn’t exist, it will be created. |
groupname | A text string (path) specifying the location of the HDF5 group. Missing intermediate groups will be created automatically. |
Return Value
On success, h5newGroup returns groupname (string).
On error, an error message (string) is returned.
Examples
Create an HDF5 group at location /My/new/HDF5 group.
h5newGroup("sample.h5", "/My/new/HDF5 group")
Error Conditions
The following conditions will create an error:
- An invalid file name
- An empty string or a string that contains characters not supported by the operating system
- It refers to a file system location for which the user has insufficient access privileges.
- It refers to a read-only file.
- An invalid group name
- An empty string
- No HDF5 object that is not an HDF5 group exists at the specified location
- Missing intermediate groups cannot be created.
See Also