Function Reference


_StringInsert

Inserts a string within another string

#include <String.au3>
_StringInsert ( $sString, $sInsertion, $iPosition )

Parameters

$sString Original string
$sInsertion String to be inserted
$iPosition Position to insert the insertion string (negatives values will insert from the right hand side)

Return Value

Success: a new modified string.
Failure: the original string and sets the @error flag to non-zero.
@error: 1 - Invalid position

Remarks

Use negative position values to insert the string from the right hand side.

Example

#include <MsgBoxConstants.au3>
#include <String.au3>

Example()

Func Example()
        ; Variable to store the output
        Local $sOutput = ""

        ; Inserts three "moving" underscores and prints them to the console.
        For $i = -20 To 20
                $sOutput &= $i & @TAB & _StringInsert("Supercalifragilistic", "___", $i) & @CRLF
        Next

        ; Display the output
        MsgBox($MB_SYSTEMMODAL, "", $sOutput)
EndFunc   ;==>Example