HPlogo MPE/iX Intrinsics Reference Manual > Chapter 9 Command Definitions (MAIL-PUTJCW)

NLNUMSPEC

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

NM and CM callable.

Returns the information needed for formatting and converting numbers. It combines several calls to NLINFO to simplify the use of native language formatting. By calling NLNUMSPEC once, and passing the obtained information to NLFMTNUM and NLCONVNUM, implicit calls to NLNUMSPEC from NLFMTNUM and NLCONVNUM are avoided and performance is improved.

Syntax


             I16V     U16A    U16A
  NLNUMSPEC (langnum, string, error);

Parameters

langnum

16-bit signed integer by value (required)

Contains the language ID number.

string

16-bit unsigned integer array (required)

Contains >= 60 bytes, where the following information is returned:

BytesMeaning
00-01Language identification number (integer)
02-03Alternate digit indicator (integer)
0 - No alternate digits exist
1 - Alternate digits exist
06-07Alternate digit range (0,9)
08Decimal separator (ASCII-digits)
09Decimal separator (alternate-digits)
10Thousands separator (ASCII-digits)
11Thousands separator (alternate-digits)
12'+' (alternate-digits)
13'-' (alternate-digits)
14Right-to-left space
15Reserved for the operating system
16-17Currency place (integer)
0 - Currency symbol
1 - Currency symbol succeeds the number
2 - Currency symbol replaces the decimal separator
3 - Currency symbol precedes the sign
18-19Length of currency symbol (integer), includes spaces
20-37Currency symbol, includes spaces
38-59Reserved for the operating system

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:

ValueMeaning
0Successful
1*NLS not installed
2*Specified language not configured
3Invalid string
5*NLS internal error
6*NLS internal error

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

Operation Notes

Split-stack calls are not permitted.

The intrinsic combines NLINFO calls with itemnums 9, 10, 31, 32, and 33. The information is formatted where needed (for example, any spaces in the currency symbol/name are included). The currency symbol/name is the shortest nonblank descriptor, as returned from NLINFO itemnums 10 and 31.

This intrinsic does not provide any information not obtainable with NLINFO. It is included for the convenience of the NLS user. For efficiency, the user of this intrinsic calls it only once, saves the result, and calls NLFMTNUM and/or NLCONVNUM multiple times.

Related Information

Intrinsics NLCONVNUM, NLFMTNUM
Manuals Native Language Programmer's Guide



NLMATCHINIT

NLREPCHAR