Next: , Previous: , Up: Procedural Language Interpreter Functions   [Index]


6.14.3.7 x1f4_lame_shuffle

extern int x1f4_lame_shuffle
    (void *data, int (*this)(void *, const char *, unsigned),
     const char *program, unsigned flags, struct x1f4_a1record_type *a1record,
     struct x1f4_eelookup_type *eelookup);

The x1f4_lame_shuffle function details the syntax error that prevented successful program parsing.

See Procedural Program Parsing 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 (including 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 and partially by the calling application.

See struct x1f4_a1record_type.

Some of the a1record features are only observed if their availability is hinted by flags.

See Procedural Language Interpreter Error Formatter Hints.

Extra information required to format the error report is collected from the parsing context description eelookup argument.

See struct x1f4_eelookup_type.

The extra information that may be required for formatting the error report includes:

The eelookup argument is always examined and may not be passed as NULL.

See x1f4_stat_shuffle.