Replaces characters within a specified ASCII code range with a particular

        <cReplaceCharacter>) --> cString


     <cCharacter1> and <cCharacter2>  Designate the first and the
     last character of the character range.

     <cString>  [@]  Designates the string that is processed.

     <cReplaceCharacter>   Designates the single character that replaces
     those characters in <cString> that are within the specified range.


     The processed character string is returned.


     All characters that are in a particular range can be replaced by a new
     character.  For example, you could replace all control characters with

     The designated range can also run from "back to front", meaning that
     <cCharacter2> can have a lower value than <cCharacter1>.  In such a case
     the range extends from the larger value to 255 and from 0 to the smaller


     .  The length of <cString> remains unaffected by this function.

     .  The return value of this function can be suppressed by
        implementing CSETREF() to save room in working memory.


     .  Exchange all control characters in a character string for the
        character ".":

        cString  :=  "a" + CHR(5) + "b" + CHR(9)
        ? RANGEREPL(CHR(0), CHR(31), cString, ".")   // "a.b."

     .  A null string can be specified, instead of CHR(0).  The
        following example exchanges all characters with a code < "A" for the
        number "0".  Of course, the number "0" remains the number "0":

        ? RANGEREPL("", CHR(65), "123400", "0")      // "000000"

     .  All characters in the range "0" to "8" are exchanged for the
        number "9":

        ? RANGEREPL("0", "8", "0212 - 78 67 43", "9")
                                                     // "9999 - 99 99 99"

     .  With the exception of upper case letters, all characters are
        exchanged for dashes.  The optimum call is in conjunction with

        cString  :=  "A()&BC/?D"
        RANGEREPL(91, 64, @cString, "-")             // "A--BC--D"

See Also: POSREPL() CHARREPL() CSETREF() Introduction


Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.