This function attaches to the point using the pointname parameter as the identifier.

Examples

---

In this example, we attach to the previously created point, “ExamplePoint”, within the HDF file, PointFile.hdf, referred to by the handle, fid:

pointID = EOS_PT_ATTACH(fid, "ExamplePoint")

The point can then be referenced by subsequent routines using the handle, pointID.

Syntax

---

Result = EOS_PT_ATTACH(fid, pointname)

Return Value

---

Returns the point handle (pointID) if successful and FAIL (–1) otherwise.Typical reasons for failure are an improper point file id or point name.

Arguments

---

fid

Point file id (long) returned by EOS_PT_OPEN.

pointname

Name of point (string) to be attached.

Keywords

---

None

Version History

---

5.2	Introduced

See Also

---

EOS_PT_DETACH