charset Method

This method is deprecated and should not be used in Profile versions v6.4 and above.

Class: Runtime

Description

This method returns the entire character set into a variable.

 

The implementation of this method in Profile V6.3 was based on calls to utilities that returned all uppercase characters and all lowercase characters, and a well-known, limited set of punctuation character. With the addition of support for Unicode, it is no longer possible to construct the entire character set as a single String of ordered characters.

Application code that is supposed to be Unicode independent shall not contain calls to this method. Please be aware that the String returned by this method relies on values returned by utilities that may not even be present in a GT.M environment that supports Unicode. In that case, code that contains Runtime.charset() will not compile, even if the value of Runtime.charsetName equals "M".

Syntax

Runtime.charset()

Parameters

None

Returns

A string variable containing the character set (digits and alphabetic) from the character set installed for the Profile customer. The string is a non-delimited list of characters in the order of the collating sequence of the character set in use.

 

Note that this collating order only applies to Strings that are compared in a PSL context. The order in which rows will be returned from a cursor with ORDER-BY-clause is determined by the underlying database system. For MDB environments this will indeed be the same order as maintained by PSL. However, for RDB environments the underlying RDB may implement a collation algorithm that differs from PSL's collation algorithm.

When Became Available

Profile v6.3

Example

set CHARSET = Runtime.charset()