NLJUDGE

Syntax

  I16V                I16V     CA        I16V
  n2bytes := NLJUDGE (langnum, instring, stringlength,
                             CA     U16A   U16A
                             flags, error, charset);

Functional Return

n2bytes

16-bit signed integer (assigned functional return)

Contains the number of 2 byte Asian characters in a 16-bit signed integer value that can be used to check a string of characters for Asian characters.

Parameters

langnum

16-bit signed integer by value (required)

Contains the language ID number.

instring

character array (required)

Contains the string of characters to be judged.

stringlength

16-bit signed integer by value (required)

Specifies the number of bytes in instring.

flags

character array (required)

Contains one of the following values (ASCII characters):

Value	Meaning
0	1 byte character
1	First byte of a 2 byte character
2	Second byte of a 2 byte character
3	Invalid Asian character

error

16-bit unsigned integer array (required)

Returns two elements: the first element is the error number; the second element is reserved and always returns 0. The possible error number values are:

Value	Meaning
0	Successful
1	*NLS not installed
2	*Specified language not configured
3	Invalid string length
4	Not returned
5	*NLS internal error
6	*NLS internal error
7	*Invalid characters found in instring

* Does not apply to calls with a langnum equal to 0 (NATIVE-3000/XL).

charset

16-bit unsigned integer array (optional)

Contains the character set definition for the language to be used, as returned by itemnum=12 of NLINFO.

Related Information