LOWERCASE

8.4

The LOWERCASE instruction translates characters in the logical string of a character variable into lower case characters. This translation occurs using the current runtime translation tables or a table specified by a user variable.

Where:

label

Optional. A Program Execution Label.

source

Required. A previously defined Character String Variable or National Character String Variable for which the characters found in the logical string are translated to lower case.

sep

Required. A comma or one of the following prepositions: BY, TO, OF, FROM, USING, WITH, IN, or INTO.

dest

Optional. A DIM or NCHAR variable to receive the data from the logical string of the {source} variable.

table

Optional. A DIM variable that identifies the character set used to translate the {source} characters to lower case.

Flags Affected: EQUAL, EOS

Note the following:

1. The {source} Form Pointer and Length Pointer values are unchanged unless the {dest} is specified and it is the same as the {source}.

2. The Logical String of {source} is moved into the {dest} variable. If the {source} is a NULL variable, the {dest} is changed to be a NULL variable.

3. If {dest} is specified, its Form Pointer is set to one.

4. The EQUAL flag is set if any character in the {source} is changed to lower case during the move process.

5. The EOS flag is set if the {dest} variable is too small to receive all of the data from the logical string of the {source} variable.

6. The {table} variable must have a logical string size of 256 characters or an F07 error occurs.

7. The {table} translation occurs by using the character value for a character in the {source} variable to index into the {table} variable to retrieve the replacement character.

See Also: Example Code, Character String Instructions