String Substitution Variable Parameters
The following are examples of String Substitution Variable Parameters.
| Parameter | Description | Example Value | Variable | Result |
| f | Trims any spaces from the beginning and end of the variable result | S=' Error Occurred ' | &S|t|; | 'Error Occurred' |
| tl | Trims any spaces from the beginning of the variable result | S=' Example text' | &S|tl|; | 'Example text' |
| tr | Trims any spaces from the end of the variable result | S='Example text ' | &S|tr|; | 'Example text' |
|
l |
Converts the variable result to lower case |
S='Example Text' |
&S|l|; |
'example text' |
|
u |
Converts the variable result to upper case |
S='Example Text' |
&S|u|; |
'EXAMPLE TEXT' |
| p | Converts the variable result to proper case. i.e. the first letter of each word is a capital followed by lower case characters |
S='EXAMPLE text' |
&S|p|; |
'Example Text' |
|
P |
The same as the 'p' parameter but preserves any existing capital letters |
S='EXAMPLE text' |
&S|P|; |
'EXAMPLE text' |
|
n- |
Removes the first n characters from the variable result |
S='Example text' |
&S|-3|; |
'mple text' |
|
-n |
Removes the last n characters from the variable result |
S='Example text' |
&S|-3|; |
'Example t' |
| n+ | Returns the first n characters from the variable result | S='Example text' | &S|4+|; | 'Exam' |
| +n | Returns the last n characters from the variable result | S='Example text' | &S|=4|; | 'text' |
| 's'- | Removes all characters from s to the end of the variable result | S='Example text' | &S|'ple'-|; | ' text' |
| -'s' | Removes all characters from s to the end of the variable result | S='Example text' | &S|-'ple'|; | 'Exam' |
| 's'+ | Returns all characters up to and including s from the beginning of the variable result | S='Example text' | &S|'ple'+|; | 'Example' |
| +'s' | Returns all characters from s to the end of the variable result | S=Example text' | &S|+'test'|; | 'ple text' |
| s | Instructs the software that the variable result should be treated as a string | N=1784.23 | &N|s|-4|; | '178' |