Programmer Guide/Command Reference/TRIM: Difference between revisions
m (1 revision: Initial import) |
No edit summary |
||
| (6 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:{{SUBPAGENAME}}}} | {{DISPLAYTITLE:{{SUBPAGENAME}}}} | ||
{{PG_StringCommands}} | |||
TRIM [ /Blanks ] [ /Characters=<var>abcde</var> ] /Leading|Trailing [ /Variables ] /- <var>string(s)</var> | |||
<code>TRIM | The {{Stx}} <code>TRIM</code> command removes characters from the beginning and/or from the end of one or more strings. | ||
For each supplied string, the {{STx}} <code>TRIM</code> command will remove all leading (option "<code>/Leading</code>") and/or trailing ("<code>/Trailing</code>") occurrences of any white space character (option "<code>/Blanks</code>") and/or of any character supplied as an argument to the "<code>/Characters</code>" option (both options may be combined). | |||
For each supplied string, the <code>TRIM</code> command will remove all leading (option "/ | |||
The command returns the trimmed strings or, if more than one string is supplied, a blank-separated list of trimmed strings. | The command returns the trimmed strings or, if more than one string is supplied, a blank-separated list of trimmed strings. | ||
If option "/ | If option "<code>/Variables</code>" is supplied, the arguments are considered to be the names of {{STX}} variables. In this case, the trimmed content of the respective variables is returned. The variables themselves are not altered. | ||
Examples | == Examples == | ||
#a := trim /l /b /- ' string ' | |||
#a := trim /l /b /- ' string ' | |||
will remove all leading white space characters | will remove all leading white space characters | ||
#a := trim /b /l /c=abc 'aaastringccc' | |||
#a := trim /b /l /c=abc 'aaastringccc' | |||
will remove all leading and trailing occurrences of the characters "a", "b", and "c". | will remove all leading and trailing occurrences of the characters "a", "b", and "c". | ||
Latest revision as of 11:17, 15 February 2019
TRIM [ /Blanks ] [ /Characters=abcde ] /Leading|Trailing [ /Variables ] /- string(s)
The STx TRIM command removes characters from the beginning and/or from the end of one or more strings.
For each supplied string, the STx TRIM command will remove all leading (option "/Leading") and/or trailing ("/Trailing") occurrences of any white space character (option "/Blanks") and/or of any character supplied as an argument to the "/Characters" option (both options may be combined).
The command returns the trimmed strings or, if more than one string is supplied, a blank-separated list of trimmed strings.
If option "/Variables" is supplied, the arguments are considered to be the names of STx variables. In this case, the trimmed content of the respective variables is returned. The variables themselves are not altered.
Examples
#a := trim /l /b /- ' string '
will remove all leading white space characters
#a := trim /b /l /c=abc 'aaastringccc'
will remove all leading and trailing occurrences of the characters "a", "b", and "c".
