Skip to main content

This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.

For information on migrating to InterSystems IRIS, see How to Migrate to InterSystems IRIS, available on the WRC Distributions page (login required).

CHARS

Returns the character corresponding to the specified character code for each element of a dynamic array.

Synopsis

CHARS(dynarray)

Arguments

dynarray An expression that resolves to a dynamic array of base-10 integers that identify characters. For 8-bit characters, each element value must be a positive integer in the range 0 through 255. For 16-bit characters, each element value must be a positive integer in the range 256 through 65534.

Description

The CHARS function takes a dynamic array of character codes and returns the corresponding characters. It returns these values as a dynamic array. The SEQS function takes a dynamic array of characters and returns the corresponding character codes.

Numbers from 0 to 31 are the same as standard, nonprintable ASCII codes. For example, CHARS(10) returns a linefeed character.

Note:

CHARS and UNICHARS are functionally identical. On Unicode systems both can be used to return 16-bit Unicode characters. On 8-bit systems, these functions return a null string for character codes greater than 255.

The Caché MVBasic CHARS function returns a dynamic array of characters. The corresponding ObjectScript $CHAR function returns a string of characters by specifying a comma-separated list of character codes.

Examples

The following example uses the CHARS function to return the characters associated with each specified character code:

a=65:@VM:66:@VM:67:@VM:68
PRINT CHARS(a);  ! returns AýBýCýD

The following example uses the CHARS function to return the first four letters of the Greek alphabet. On a Unicode version of Caché it returns the Greek letters in a dynamic array; on an 8-bit version of Caché it returns a dynamic array with a null string for each letter:

b=945:@VM:946:@VM:947:@VM:948
PRINT CHARS(b)

See Also

Feedback