Guardian Procedure Calls Reference Manual

FORMATDATA[X] Procedures
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
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.
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
#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 );
632 Guardian Procedure Calls (F)