[<<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