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:

  1. 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

h5newGroup