Retrieves a part of the text specified and places the result in a variable. Generally used as a text manipulation tool to retrieve specific text from a text value.
Declaration
<AMTEXTGETSUBTEXT TEXT="text" STARTPOSITION="number" LENGTH="number" RESULTVARIABLE="text(variable name)" />
See Also: Find Text, Get Subtext, Insert Text, Pad Text, Replace Text, Trim Text, Format Date/Time, Convert Case, Pad Text
|
Property |
Type |
Required |
Default |
Markup |
Description |
|
Original Text |
Text |
Yes |
(Empty) |
TEXT="My name is Joe" |
The target text to retrieve the subtext from. As with every text parameter, if the data you want to enter is contained in a variable, enter the variable name surrounded by percentage signs to resolve it to it's contents at runtime (i.e. %VarName%). |
|
Starting Position |
Number |
Yes |
(Empty) |
POSITION="24" |
The position in the text in which retrieval should begin. |
|
Length of text to get |
Number |
No |
(Empty) |
LENGTH="3" |
The number of characters to retrieve. |
|
Populate variable with result |
Text |
Yes |
(Empty) |
RESULTVARIABLE="varname" |
The variable to be populated with the new value. |