%TRIML (Trim Leading Characters)

%TRIML(string {: characters to trim})

%TRIML with only one parameter returns the given string with any leading blanks removed.

%TRIML with two parameters returns the given string with any leading characters that are in the characters to trim parameter removed.

The string can be character, graphic, or UCS-2 data.

If the characters to trim parameter is specified, it must be the same type as the string parameter.

When specified as a parameter for a definition specification keyword, the string parameter must be a constant.

Note: Specifying %TRIML with two parameters is not supported for parameters of Definition keywords.

For more information, see String Operations or Built-in Functions.

Figure 1. %TRIML Example

 *..1....+....2....+....3....+....4....+....5....+....6....+....7...+....
 * LOCATION will have the value 'Toronto, Ontario  '.

 /FREE   
     // Trimming blanks
     Location = %triml('  Toronto, Ontario  ');
     // LOCATION now has the value 'Toronto, Ontario  '.

     // Trimming other characters

     trimmed = %triml('$******5.27***        ' : '$* ');
     // trimmed is now '5.27***        '