Creating Files: h5newFileΒΆ
h5newFiles creates a new HDF5 file. If no file name is provided, a random file name will be generated and returned. Existing file will not be overwritten and an error will be generated instead.
Excel UDF Syntax
h5newFile()
h5newFile([filename])
Optional Arguments
Argument | Description |
---|---|
filename | A text string specifying the name of an HDF5 file. |
Return Value
On success, h5newFile returns the file name of the newly created file.
On error, an error message (string) is returned.
Examples
Create an HDF5 file at location c:\tmp\sample.h5.
h5newGroup("c:\tmp\sample.h5")
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.
- A file exists at that location.
See Also