Guardian Procedure Calls Reference Manual

NUMOUT Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Related Programming Manual
Summary
The NUMOUT procedure converts unsigned integer values to their ASCII equivalents. The result is
returned right-justified in an array. Any preceding blanks are zero filled.
Syntax for C Programmers
#include <cextdecs(NUMOUT)>
void NUMOUT ( char *ascii-result
,short unsigned-integer
,short base
,short width );
Syntax for TAL Programmers
CALL NUMOUT ( ascii-result ! o
,unsigned-integer ! i
,base ! i
,width ); ! i
Parameters
ascii-result
output
STRING:ref:*
is an array where the converted value returns. The ASCII representation is right-justified in
ascii-result[0:width -1]. Any preceding blanks are zero filled.
unsigned-integer
input
INT:value
is the value to be converted.
base
input
INT:value
is the number base for the resulting conversion. Any number in the range 2 to 10 is valid.
width
input
INT:value
is the maximum number of characters permitted in ascii-result. Characters might be
truncated on the left side.
NUMOUT Procedure 885