MPE/iX Intrinsics Reference Manual (32650-90875)

58 Chapter4
Command Definitions (ABORTSESS - FCLOSE)
ASCII
• For decimal conversions, binvalue is considered a 16-bit, twos
complement integer ranging from -32768 to +32767. If
binvalue =0,
only one zero character is returned in
asciieqv ; numchar returns the
total number of characters (including the sign). For example, if
binvalue =0, the length returned is 1; and if binvalue =327, the
length returned is 3.
• For decimal left-justified conversions (
base =10), leading zeros are
removed, and the numeric ASCII result is left-justified in
asciieqv ;
the most significant digit (or the “-” sign) is in
asciieqv (1), the next
most significant digit is in
asciieqv (2), and so on.
• For decimal right-justified conversions (
base =-10), the result is
right-justified in
asciieqv ; the least significant digit is in
asciieqv (-1), the next least significant digit is in asciieqv (-2), and so
on.
• For right-justified conversions, the character array where the converted
value is to be placed must specify the rightmost byte where data is
placed. For example, if
asciieqv is a 10 byte array declared as:
VAR
MYSTRING : ARRAY [1..10] OF CHAR;
then you must specify it in the ASCII intrinsic call as follows (for right
justification):
NUMCHAR:=ASCII(VALUE,-10&
,WADDRESS(MYSTRING[10]));
The result is right-justified in
asciieqv , with the rightmost digit of the
result contained in the last (rightmost) byte of
asciieqv .
• For hexadecimal conversions (
base =16), 4 characters (including
leading zeros) are returned. The digits can be 0..9 and A..F.
Numchar
returns the number of significant (right-justified) characters (excluding
leading zeros). For example, if
binvalue =32, numchar is 2 and
asciiqv will be 0020.
NOTE For all right-justified conversions asciieqv must be initialized to blanks
before the call is made.
Related Information
Intrinsics DASCII, BINARY, DBINARY
Manuals Data Types Conversion Programmer's Guide