gdaCreate¶
Purpose¶
Creates a GAUSS Data Archive.
Format¶
-
retcode =
gdaCreate(filename, overwrite)¶ - Parameters:
filename (string) – name of data file to create.
overwrite (scalar) –
one of the following:
0
error out if file already exists.
1
overwrite file if it already exists.
- Returns:
retcode (scalar) –
return code, 0 if successful, otherwise one of the following error codes:
1
Null file name.
3
File write error.
6
File already exists.
7
Cannot create file.
Examples¶
/*
** Create a GDA named `myfile`
** and overwrite existing `myfile`
*/
ret = gdaCreate("myfile.gda", 1);
Remarks¶
This command creates a GAUSS Data Archive containing only a header. To
add data to the GDA, call gdaWrite().
It is recommended that you include a .gda extension in filename().
However, gdaCreate() will not force an extension.
See also
Functions gdaWrite()