Converts a string of letters to upper case.
Syntax:
call "CBL_TOUPPER" using string
by value length
returning status-code
Parameters:
| |
Using call prototype (see
Key)
|
Picture
|
|
string
|
pic x(n).
|
pic x(n).
|
|
length
|
cblt-os-size
|
pic x(4) comp-5
or
pic x(8) comp-5 (64-bit native programs only)
|
|
status-code
|
See
Library Routines - Key
|
|
On Entry:
|
string
|
The string to convert.
|
|
length
|
The number of bytes of
string to change; positions beyond this are unchanged.
|
On Exit:
|
string
|
The converted string.
|
Comments:
The routine starts at the left-hand end of string and converts letters to upper case (also called folding to upper case).