Name

---

  MGH_NBENCH

Purpose

---

  This procedure reads the contents of a file & writes them to
  another file. Cf. my Python script nbench.

Calling Sequence

---

  MGH_NBENCH, InFile, OutFile

Inputs

---

  infile
      Input file name.
  outfile
      Output file name.

Keyword Parameters

---

  BUFSIZE
      This keyword has an effect only when the TEXT keyword *is not*
      set. It specifies the size (in bytes) of chunks read &
      written. Default is 2^16 (64kiB)
  GUNZIP
      If this keyword is set, read compressed data.
  GZIP
      If this keyword is set, write compressed data.
  TEXT
      If this keyword is set, treat the file as a text file,
      transferring data line-by-line with formatted
      read/writes. Otherwise, transfer data via a buffer with
      unformatted read/writes of byte data.
  UNIX
      This keyword has an effect only when the TEXT keyword *is*
      set. When UNIX is set, the lines of text are written via
      unformatted writes terminated with a 10B character. Thus
      Unix-format files are produced on all platforms.
###########################################################################
  This software is provided subject to the following conditions:
  1. NIWA makes no representations or warranties regarding the
    accuracy of the software, the use to which the software may
    be put or the results to be obtained from the use of the
    software. Accordingly NIWA accepts no liability for any loss
    or damage (whether direct of indirect) incurred by any person
    through the use of or reliance on the software.
  2. NIWA is to be acknowledged as the original author of the
    software where the software is used or presented in any form.
###########################################################################

Modification History

---

  Mark Hadfield, 2001-12:
      Written.