Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-245
FORMATDATA[X] Procedure
FORMATDATA[X] Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Example
Related Programming Manual
Summary
The FORMATDATA (which is superseded by FORMATDATAX) and FORMATDATAX
procedures convert data item values between internal and external representations, as
specified by a format (previously converted from external to internal form by
FORMATCONVERT[X]) or by the list-directed conversion rules. The FORMATDATA
and FORMATDATAX procedures are identical, except that FORMATDATA requires that
all of its reference parameters be 16-bit addresses, while FORMATDATAX accepts
extended (32-bit) addresses for all of its reference parameters.
Syntax for C Programmers
Note. The FORMATDATA procedure cannot be called by native processes. Although this
procedure is supported for TNS processes, it should not be used for new development. Use
the FORMATDATAX procedure.
#include <cextdecs(FORMATDATA)>
short FORMATDATA ( char _near *buffer
,short bufferlen
,short buffer-occurs
,short _near *length
,short _near *iformat
,short _near *variable-list
,short variable-list-len
,short flags );
#include <cextdecs(FORMATDATAX)>
short FORMATDATAX ( char *buffer
,short bufferlen
,short buffer-occurs
,short *length
,short *iformat
,short *variable-list
,short variable-list-len
,short flags );