NLJUDGE

Syntax

  I16V                I16V     CA        I16V          CA
  n2bytes := NLJUDGE (langnum, instring, stringlength, flags,
  
    U16A   U16A
    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

* Do not apply to calls with langnum equal to 0 (NATIVE-3000).

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

Intrinsics

NLCOLLATE, NLKEYCOMPARE, NLREPCHAR, NLSCANMOVE, NLSWITCHBUF, NLSTRANSLATE

Manual

Native Language Programmer's Guide