Next: x1f4_tail_shuffle, Previous: x1f4_slip_shuffle, Up: Procedural Language Interpreter Functions
extern int x1f4_stat_shuffle (void *data, int (*this) (void *, const char *, unsigned), const char *program, struct x1f4_a1record_type *a1record, struct x1f4_c1lookup_type *c1lookup);
The x1f4_stat_shuffle
function details the syntax error that prevented
successful program parsing.
See Error Reporting.
The text describing the encountered error is output via the this
method
called with the error reporting data
context as its first argument and
the address and the length of the string for each of the strings making up the
error report as its second and third arguments. The data
and
this
arguments are not further interpreted.
The program
program textual representation is used for building the
error message (which may include determining the line number on which the
program parsing failed).
The error record a1record
is expected to have been setup by the failed
program parsing function call.
See struct x1f4_a1record_type.
Extra information required to format the error report is collected from the
parsing context description c1lookup
argument.
See struct x1f4_c1lookup_type.
The extra information that may be required for formatting the error report is:
See Application Defined Types.
If no application types have been defined the parsing context description
c1lookup
argument of the x1f4_stat_program
function is not
used.