RPG Cafe: New built-ins %LOWER, %UPPER, and %SPLIT

Content

New built-in functions %LOWER, %UPPER, and %SPLIT

• %LOWER and %UPPER: You can convert all or part of a string to lowercase or uppercase.
• %SPLIT: You can split a string into an array of substrings.

Details

%LOWER and %UPPER

%LOWER converts all alphabetic characters to lowercase, and %UPPER converts all alphabetic characters to uppercase.

If you want to convert only some of the characters in the string, use the start and length operands to specify the substring to convert. The built-in function returns the entire string.

In the following example, %LOWER is used to convert the characters from position 2 to the end of the string to lowercase.

          string = 'RENÉE';
          string2 = %LOWER(string : 2);
          // string2 = "Renée"

%SPLIT

%SPLIT returns an array of substrings.

By default, %SPLIT splits at blanks.

The second "separators" parameter can be a list of the characters you want to split at.

Leading and trailing separators are ignored. If there is more than one separator in a row, the extra separators are ignored.

You can use FOR-EACH to process the result of %SPLIT.

In this example, %SPLIT defaults to splitting at blanks. In second example, the second parameter specifies several characters to split at.

          array = %SPLIT(' a  bcd   ef');
          // array(1) = "a"
          // array(2) = "bcd"
          // array(3) = "ef"

          sentence = 'Hello, how are you?';
          FOR-EACH x IN %SPLIT(sentence : '.,:;!? ');
             ...
          ENDFOR
          // In the loop, 'word' has the values
          //    "Hello"
          //    "how"
          //    "are"
          //    "you"

.                                                            .

.                                                            .