FT_BYTENOT()
 Perform bit-wise NOT on an ASCII character (byte)
──────────────────────────────────────────────────────────────────────────────

 Syntax

      FT_BYTENOT( <cByte> ) -> cNewByte

 Arguments

     <cByte> is a character from CHR(0) to CHR(255).
     May be passed in CHR() form, as character literal, or
     as expression evaluating to CHR() value.

 Returns

     Returns resulting byte, in CHR() form.  If parameters are faulty,
     returns NIL.

 Description

     Can be used for bitwise byte manipulation.  In effect, this is a
     bit-by-bit NOT (one's complement) operation.  Equivalent to the
     NOT assembler instruction.

     This function is presented to illustrate that bit-wise operations
     are possible with Clipper code.  For greater speed, write .C or
     .ASM versions and use the Clipper Extend system.

 Examples

     This code performs a bitwise NOT on byte represented by CHR(32):

          cNewByte := FT_BYTENOT( CHR(32) )
          ? ASC( cNewByte )     // result: 223

     For a demonstration of Clipper bit manipulations, compile and
     link the program BITTEST.PRG in the Nanforum Toolkit source code.

 Source: BYTENOT.PRG

 Author: Forest Belt, Computer Diagnostic Services, Inc.