Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- CA-Clipper Tools . Books 1-3 - <b>posins()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 POSINS()
 Inserts characters at a particular position within a string
------------------------------------------------------------------------------
 Syntax

     POSINS(<cString>,<cInsertstring>,[<nPosition>])
        --> cString

 Arguments

     <cString>  Designates the character string into which characters are
     inserted.

     <cInsertstring>  Designates the new characters that are inserted
     into <cString>.

     <nPosition>  Designates the position where the new characters are
     inserted within <cString>.  The default value inserts the characters in
     front of the last character.

 Returns

     POSINS() returns the string with the inserted characters.

 Description

     You can use POSINS() to insert characters into an existing character
     string.  The <cInsertstring> characters are inserted into the <cString>
     at the location specified by <nPosition>.

 Note

     .  The resulting character string is longer than the original, so
        this function cannot be called by reference.

 Examples

     .  Insert "123" at position 2:

        ? POSINS("abcdefgh", "123", 2)   // "a123bcdefgh"

     .  Insert "123" at position 8:

        ? POSINS("abcdefgh", "123", 8)   // "abcdefg123h"

     .  Give an erroneous position:

        ? POSINS("abcdefgh", "123", 10)  // "abcdefgh"


See Also: POSDEL() POSREPL()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson