Insert
ActionStep Reference » Programming » String Operation » Addendum » Insert
The ActionStep Insert places a single character or sequence of characters on a specified position in a string and stores the new string in Result of the result list.
- Open the Programming node in the Workspace Explorer.
- Open the String Operation node.
- In the Addendum node, select the Insert ActionStep.
Parameters:
The ActionStep has the following input parameters:
| name |
Description
|
|---|---|
| String |
The string to be modified.
Allowed Context Scopes [Fixed, Local, Global] Allowed Context Types [Variable, Parameter, Enum] |
|
Insert String
|
The string to be inserted.
Allowed Context Scopes [Fixed, Local, Global] Allowed Context Types [Variable, Parameter, Enum] |
|
Insert Index
|
Specifies the position where the Insert String parameter is to be placed.
Allowed Context Scopes [Fixed, Local, Global] Allowed Context Types [Variable, Parameter, Enum] |
Results:
The ActionStep returns the following results:
|
name
|
description
|
|---|---|
| Result |
Contains the new string.
Allowed Context Scopes [Fixed, Local, Global] Allowed Context Types [Variable, Parameter] |
|
An exception occurs when the value of the Insert Index parameter is set to a negative number or greater than the length of the String parameter.
|
Example 1 (Adds a text between the string of a variable):
This example inserts a text to the local String 1 variable with Text as data type. The text is inserted in the 4th index position of the String 1 variable. The Result of the new string is then output via Speech Output.
Example 2 (Adds whitespace within the string of a variable):
This example inserts whitespace to the local String 1 variable with Text as data type. The whitespace is inserted in the 8th index position of the string. The Result of the new string is then output via Write Text.
Example 3 (Inserts a currency symbol to a variable):
This example inserts a currency symbol from a local currentSymbol variable to the local price variable with Text as data type. The currency symbol is inserted in the 1st index position of the string. The Result of the new string is then output via Message Box.
