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()