pTAL Conversion Guide

pTAL Built-In Routines
pTAL Conversion Guide—527302-002
18-25
$FIXEDTOASCII
$FILL32 performance is significantly degraded if area-to-fill is not aligned to at
least a 4-byte boundary.
None of the fill procedures ($FILL8, $FILL16, $FILL32) perform bounds-checking on
their parameters. If you write more bytes than the size of area-to-fill, the results
are undefined. You might overwrite other data in your program with no immediate error,
or you might cause any of several addressing errors, such as attempting to write in an
area for which you do not have write permission, attempting to write in an unmapped
page, and so forth.
$FIXEDTOASCII
$FIXEDTOASCII converts the absolute value of a FIXED value to a string of ASCII-
coded, base-10 digits, and stores the result in memory.
qvalue input
FIXED(*):value
is a quadrupleword integer value to convert to ASCII digits.
bufferaddr input
BADDR:value
is the byte address at which to write the ASCII digits.
Example 18-16. Call to $FILL8 Routine
PROC a MAIN;
BEGIN
STRUCT s(s_t);
...
CALL $FILL8(s, $LEN(s), 0);
END;
pTAL privileged procedure No
Can be executed only by privileged procedures No
Sets condition code No
Sets $CARRY No
Sets $OVERFLOW Yes
$FIXEDTOASCII ( , ,
bufferaddr
) ;maxdigits
VST617.vsd
qvalue