We do minimal error trapping in order to keep our code fast and
 small. This means that you can shoot yourself in the foot rather
 easily if you are not careful.  We do not want to burden the skilled
 programmer with limitations suitable for the worst-case novice.

 Functions respond to errors in different ways depending upon
 the data type of their return value.

 Return Type     Return for Error Condition
 ═══════════     ═════════════════════════════════════════════════
 Character       Error message --- see below
 Date            Blank date: "  /  /  "
 Logical         .F.
 Numeric         -1, zero, or INFINITY() --- see specific function

 Only the functions that return a character expression <expC>
 will return an error message.  The error messages are

 Message                 Meaning
 ═════════════════════   ══════════════════════════
 TR.LIB ERROR:           Prefix to all other errors
 SYNTAX                  Syntax error
 ALLOCATING MEMORY       Unable to allocate memory
 OPENING FILE            Unable to open file
 SEEKING FILE POSITION   Unable to seek position
 READING FILE            Unable to read file
 WRITING FILE            Unable to write file
 CLOSING FILE            Unable to close file

 Possible reasons for an error condition occurring are:

    * Programming problems
       - Syntax errors
       - Not releasing memory previously allocated

    * Disk problems
       - Drive not working
       - Out of disk space
       - Too many files in root directory
       - Bad sector

    * Hardware problems
       - Out of memory


             Placed in the Public Domain by Tom Rettig Assoc.