COLORREPL()
 Exchanges particular screen attributes
------------------------------------------------------------------------------
 Syntax

     COLORREPL([<cNewAttr|nNewAttr>],
        [<cOldAttr|nOldAttr>]) --> cNull

 Arguments

     <cNewAttr|nNewAttr>  Designates the new attribute.  The default is
     CLEARA.

     <cOldAttr|InOldAttr>  Designates the old attribute to exchange.  The
     default is all existing attributes.

 Returns

     COLORREPL() always returns a null string.

 Description

     COLORREPL() simplifies screen handling.  This function exchanges all
     occurrences of the <cOldAttr|nOldAttr> attribute for the
     <cNewAttr|nNewAttr> attribute.

     For example, after a READ, you could take the colors in all input
     fields, (assuming they have a common attribute), and change them.  This
     designates these fields as no longer active.

 Note

     .  If the <cOldAttr|nOldAttr>parameter is not specified, then all
        screen attributes (without exception) are exchanged for
        <cNewAttr|nNewAttr>.  If <cNewAttr|nNewAttr> is also missing, then
        <cOldAttr|nOldAttr> is exchanged for the CLEARA standard attribute.

 Examples

     .  Exchange the attribute 7 (white on black) for 0 (black on
        black= invisible):

        COLORREPL(0, 7)

     .  Replace all attributes for attribute 116 (red on white):

        COLORREPL(116)

     .  Exchange the attribute "7/0" (white on black) for 116 (red on
        white):

        COLORREPL(116, "7/0")

     .  Exchange all attributes for the CLEARA standard attribute:

        COLORREPL()

     .  Change the display from white on black to black on white.  You
        can specify different parameters:

        COLORREPL("0/7", "7/0")
        COLORREPL(112, 7)

     .  Mixed formats are also possible:

        COLORREPL("0/7", 7)