String - Insert

Creates a new string by inserting one string into another at a given position, and then storing the result (a new "combined" string) in a variable.

Action ID:
Action Category:
Action List Syntax:

61
String
<<VARIABLE>>
= String.Insert (<<SOURCE>>, <<STRINGTOINSERT>>, <<POSITION>>)

Settings

Store result in variable:

The variable that will hold the new (combined) string.

Source string:

The "source" string that will have the other string inserted into it.

Start at position:

The zero-based position where the Text to insert string will be inserted into the source string.

Text to insert:

The text that will be inserted into the source string.

Error Codes

Value
(%LastErrorNum%)

Simple Message
(%LastErrorMsg%)

Verbose Message
(%LastErrorDetails%)

0 (OK)

 

 

1

MSG_ERR_INSERT_STRING_SIMPLE

MSG_ERR_INSERT_STRING_SIMPLE
MSG_ERR_INSERT_STRING_NEGATIVE_POSITION
<<SOURCE>>

<<POSITION>>

2

MSG_ERR_INSERT_STRING_SIMPLE

MSG_ERR_INSERT_STRING_SIMPLE
MSG_ERR_INSERT_STRING_POSITION_TOO_LARGE
<<SOURCE>>

<<POSITION>>

Examples

None