%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 265. %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***        '


[ Top of Page | Previous Page | Next Page | Contents | Index ]