UniBasic Commands Reference - Rocket Software

CHARS
Syntax
CHARS(array)
Description
The UniBasic CHARS function changes a numeric value in array to its ASCII
(American Standard Code for Information Interchange) character string equivalent.
array elements can contain a constant, variable, numeric function, or any combination
of these. array elements must evaluate to a positive number 0–255 (the range
of ASCII character codes). CHARS supports multibyte languages.
Not all ASCII codes are printable. Some represent terminal controls, and others are
reserved for special uses. For more information about ASCII character codes, see
Appendix A, “ASCII Character Codes.”
Tip: Use @variables to represent UniData delimiters and the null value. IBM
recommends that you not use the UniBasic functions CHAR or CHARS to insert these
variables because the ASCII code that represents it varies with language group.
Example
In the following example, the program segment assigns the ASCII string equivalent
of the elements of array VAL to the variable VARRAY. VARRAY now contains
W}X}Y}Z, the character equivalent of 87,88,89, and 90 in the ASCII code system.
VAL = 87:@VM:88:@VM:89:@VM:90
VARRAY = CHARS(VAL)
Related Commands
UniBasic
ASCII, CHAR, EBCDIC, SEQ
CHARS 1-138