CBL_TOLOWER

CBL_TOLOWER

The CBL_TOLOWER library routine converts a string of letters to lower case.

Syntax:

CALL "CBL_TOLOWER" USING textString

BY VALUE length

GIVING returnCode

Parameters:

textString	PIC X(n)	Specifies the string to convert.
length	PIC X(4) COMP-5	Specifies the number of bytes of string to change; positions beyond this are unchanged.

Return code:

returnCode can be any numeric data item and provides additional information:

0	Operation successful.
-1	Operation failed.

Examples:

Example - Convert the content of wrk-string to lower case

working-storage section.

77 wrk-string pic x(12).

77 wrk-len pic x(4) comp-5.

procedure division.

main.

move "Test String" to wrk-string.

move 12 to wrk-len.

call "CBL_TOLOWER" using wrk-string, wrk-len.