MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 9 535
Command Definitions (MAIL-PUTJCW)
NLFMTNUM
NLFMTNUM
NM and CM callable.
Converts a string containing an ASCII number (can include NATIVE-3000 decimal
separator (.), thousands separator (,), and currency symbol/name ($)) to a language-specific
format using the decimal separator, thousands separator, and currency symbol/name
defined for the native language.
Syntax
I16V CA I16V CA
NLFMTNUM(
langnum,instring,inlength,outstring ,
I16V U16A U16A U16V I16V O-V
outlength,error , numspec,fmtmask,decimals )
Parameters
langnum 16-bit signed integer by value (required)
Contains the language ID number, specifying which format to use.
instring character array (required)
Contains the NATIVE-3000 formatted ASCII number to be converted (for
example, $123,456.78). Leading and trailing blanks are allowed.
inlength 16-bit signed integer by value (required)
Contains the length, in bytes, of
instring .
outstring character array (required)
Contains the returned language-specific formatted number. The decimal
separator, thousands separator, and currency symbol/name are replaced (if
present), or are inserted (if specified by
fmtmask ), according to the
language definition. The
outstring can reference the same address as
instring .
outlength 16-bit signed integer by value (required)
Contains the length, in bytes, of
outstring . After a successful call, if
outstring is returned left-justified (specified by fmtmask ), outlength
returns the actual length, in characters, of the formatted number.
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