[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
 CHARMIX()
 Mixes two strings together
------------------------------------------------------------------------------
 Syntax
     CHARMIX(<cString1>,<cString2>) --> cString
 Arguments
     <cString1>  Designates a string that is mixed with <cString2>.
     <cString2>  Designates a string that is mixed with <cString1>.
 Returns
     CHARMIX() returns a string that is double the length of <cString1>,
     assuming that <cString2> contains at least one character.
 Description
     This function allows you to mix the characters from two character
     strings together.  The characters from <cString1> and <cString2> appear
     alternately in the result string.  The length of <cString1> forms the
     basis for the maximum count of the resulting mix.  A longer <cString2>
     string is cut down to the length of <cString1>.  A shorter <cString2> is
     processed from beginning to end, wrapping to the beginning again until
     there are no more characters in <cString1>.
 Note
     .  This function can be used to recombine strings extracted by
        CHAREVEN() or CHARODD().
 Examples
     .  This is an example of a simple mix:
        ? CHARMIX("ABC", "123")       // "A1B2C3"
     .  This is a mix where the second string is shorter:
        ? CHARMIX("ABCDE", "12")      // "A1B2C1D2E1"
     .  This is a mix where the second string is longer:
        ? CHARMIX("AB", "12345")      // "A1B2"
     .  What you can do with this?
        ? CHARMIX("HELLO". " ")       // "H E L L O"
     .  If the second parameter is null, then the first parameter is
        returned unchanged:
        ? CHARMIX("HELLO", "")        // "HELLO"
See Also:
CHAREVEN()
CHARODD()
EXPAND()
SCREENMIX()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson