[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 POSREPL()
 Replaces one or more characters from a certain position
------------------------------------------------------------------------------
 Syntax

     POSREPL(<cString>,<cReplacementstring>,
        [<nStartPos>]) --> cString

 Arguments

     <cString>  [@]  Designates the character string within which the
     particular characters are replaced.

     <cReplacementstring>  Designates a sequence of characters that,
     starting at <nStartPos>, replace a portion of <cString>.

     <nStartPos>  Designates from which character within <cString> the
     replacement starts.

 Returns

     POSREPL() returns the modified string.

 Description

     When you use POSREPL(), you can replace a range of characters within
     <cString> with another character string <cReplacementstring>.  The new
     characters are exchanged beginning at <nStartPos>.

 Notes

     .  When the <nStartPos> parameter is not specified, the
        <cReplacementstring> overwrites the end of the string (see examples).

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

 Examples

     .  Starting at position 3, replace three characters with "XXX":

        ? POSREPL("ABCDEFG", "XXX", 3)         // "ABXXXFG"

     .  Replace the last LEN(<cReplacementstring>) characters:

        ? POSREPL("ABCDEFG", "XXX")            // "ABCDXXX"

     .  The result can be longer than the character string passed.

        ? POSREPL("ABCDEF", "123", 5)          // "ABCD123"
        ? POSREPL("ABCDEF", "123", 6)          // "ABCDE123"


See Also: POSINS() POSDEL() CSETREF()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson