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

# EOS_SW_ATTACH

This function attaches to the swath using the swathname parameter as the identifier.

## Examples

In this example, we attach to the previously created swath, “ExampleSwath”, within the HDF file, SwathFile.hdf, referred to by the handle, fid:

swathID = EOS_SW_ATTACH(fid, "ExampleSwath")

The swath can then be referenced by subsequent routines using the handle, swathID.

## Syntax

Result = EOS_SW_ATTACH(fid, swathname)

## Return Value

Returns the swath handle (swathID) if successful and FAIL (–1) otherwise.

## Arguments

### fid

Swath file id (long) returned by EOS_SW_OPEN.

### swathname

Name of swath (string) to be attached.

## Keywords

None

## Version History

5.2 | Introduced

## See Also

EOS_SW_DETACH