Name

---

  FILE_COMPILE

Author

---

  Craig B. Markwardt, NASA/GSFC Code 662, Greenbelt, MD 20771
  [email protected]

Purpose

---

  Compile an arbitrary procedure

Calling Sequence

---

  FILE_COMPILE, pathname, ERROR=error, ERRMSG=errmsg

Description

---

  FILE_COMPILE compiles a file containing an IDL procedure or
  function. After compilation the user may call the procedure or
  function.
  If compilation is successful, then ERROR is set to 0. If the
  compilation fails, then, ERROR is set to a non-zero error code,
  and ERRMSG is set to a descriptive error message.

Inputs

---

  PATHNAME - scalar string, path name of file containing IDL
              procedure or function. PATHNAME must end in '.pro'.
              The directory containing the file must be readable and
              it must be possible to change to that directory as a
              working directory using CD.

Keywords

---

  ERROR - upon return, a scalar integer giving status of
          compilation, either 0 for success or non-zero for failure.
  ERRMSG - upon return, a scalar string giving a descriptive error
            message.
  PRO_NAME - upon return, the name of the procedure, with path name
              and '.pro' suffix removed.

See Also

---

  RESOLVE_ROUTINE

Modification History

---

  Documented, CM, Jun 2009
  Small documentation changes, CM, 2012-10-09
  $Id: file_compile.pro,v 1.2 2012/10/17 23:53:58 cmarkwar Exp $