Routines (alphabetical) > Routines: H > HDF-EOS Routines > EOS_GD_OPEN

# EOS_GD_OPEN

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