Name

---

  FXGWRITE

Author

---

  Craig B. Markwardt, NASA/GSFC Code 662, Greenbelt, MD 20770
  craigm@lheamail.gsfc.nasa.gov
  UPDATED VERSIONs can be found on my WEB PAGE:
      http://cow.physics.wisc.edu/~craigm/idl/idl.html

Purpose

---

  Perform an unformatted write to a generic resource.

Major Topics

---

  File I/O, Pipes, URLs, FITS

Calling Sequence

---

  FXWRITE, UNIT, BUFFER, TRANSFER_COUNT=TC

Description

---

  FXGWRITE performs an unformatted write to the unit UNIT. The UNIT
  must have previously been opened by FXGOPEN with write access.
  Currently only unformatted reads are permitted because the precise
  number of bytes to written must be known ahead of time.
  In other respects, this procedure is similar to the WRITEU
  built-in IDL procedure.
  You must use the specialized 'FXG' style functions to read, write
  and seek on file units opened with FXGOPEN:
    FXGOPEN - open resource
    FXGCLOSE - close resource
    FXGREAD - read from resource
    FXGWRITE - write to resource
    FXGSEEK - seek on resource (i.e., perform POINT_LUN)
    FXGFILTERED - determine if resource is a normal file.

Inputs

---

  UNIT - the unit number to operate on. The unit must have been
          previously opened by FXGOPEN.
  BUFFER - the array to be written. Only basic types are permitted.
            The actual number of bytes transferred can be determined
            by examining the TRANSFER_COUNT.

Keyword Parameters

---

  TRANSFER_COUNT - upon output, contains the number of elements
                    transferred from BUFFER.

Modification History

---

  Written, 1999, CM
  Documented, 02 Oct 1999, CM
  Changed copyright notice, 21 Sep 2000, CM