This function creates a new file or opens an existing one.

Examples


In this example, we create a new grid file named, GridFile.hdf. It returns the file handle, fid.

fid = EOS_GD_OPEN("GridFile.hdf", /CREATE)

Syntax


Result = EOS_GD_OPEN( filename, access [, /CREATE] [, /RDWR | , /READ] )

Return Value


Returns the grid file id handle (fid) if successful and FAIL(–1) otherwise.

Arguments


filename

Complete path and filename (string) for the file to be opened.

Keywords


CREATE

If file exists, delete it, then open a new file for read/write.

RDWR

Open for read/write. If file does not exist, create it.

READ

Open for read only. If file does not exist, error. This is the default.

Version History


5.2

Introduced

See Also


EOS_GD_CLOSE