Guardian Procedure Calls Reference Manual

Syntax for TAL Programmers
error := FORMATDATA[X] ( buffer ! i,o
,bufferlen ! i
,buffer-occurs ! i
,length ! o
,iformat ! i
,variable-list ! i
,variable-list-len ! i
,flags ); ! i
Parameters
buffer
input, output
(for FORMATDATA)STRING:ref:*
(for FORMATDATAX)STRING .EXT:ref:*
is a buffer or a series of contiguous buffers where the formatted output data is placed or where
the input data is found. The length, in bytes, of buffer must be at least bufferlen *
buffer-occurs.
bufferlen
input
INT:value
is the length, in bytes, of each buffer in the buffer array.
buffer-occurs
input
INT:value
is the number of buffers in buffer.
length
output
(for FORMATDATA)INT:ref:*
(for FORMATDATAX)INT .EXT:ref:*
is an array that must have at least as many elements as there are buffers in the buffer array
on output. FORMATDATA[X] stores the highest referenced character position in each buffer in
the corresponding length element. If a buffer is not accessed, -1 is stored for that buffer and
for all succeeding ones. If a buffer is skipped (for example, due to consecutive buffer advance
descriptors in the format), 0 is stored.
There are no values stored in the length parameter during the input operation.
iformat
input
(for FORMATDATA)INT:ref:*
(for FORMATDATAX)INT .EXT:ref:*
is an integer array containing the internal format, constructed by a previous call to
FORMATCONVERT[X].
FORMATDATA[X] Procedures 633