HP 3000 Manuals

NLJUDGE [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation


MPE/iX Intrinsics Reference Manual

NLJUDGE 

NM and CM callable.

Judges whether a character is a 1 byte or 2 byte Asian character.

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 is 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

Commands              None

Manuals               Native Language Programmer's Guide (32650-90022)



MPE/iX 5.0 Documentation