Guardian Procedure Calls Reference Manual

DNUMOUT Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
The DNUMOUT procedure converts unsigned double word integer values to their ASCII equivalents.
The result is returned right-justified in an array. If necessary, leading zeros are zero-filled (the
default) or blank-filled.
Syntax for C Programmers
#include <cextdecs(DNUMOUT)>
short DNUMOUT ( char *ascii-result
,__int32_t unsigned-doubleword
,short base
,[ short width ]
,[ short flags ] );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
Syntax for TAL Programmers
width := DNUMOUT ( ascii-result ! o
,unsigned-doubleword ! i
,base ! i
,[ width ] ! i
,[ flags ] ); ! i
Parameters
ascii-result
output
STRING .EXT:ref:*
is an array where the converted value is returned in ASCII representation, right-justified in
ascii-result[width - 1], with zero-fill by default.
DNUMOUT Procedure 325