Next: x1f4_side_shuffle, Previous: x1f4_rail_shuffle, Up: Procedural Language Interpreter Functions [Index]
extern int x1f4_seek_shuffle
(void *program, unsigned *line);
The x1f4_seek_shuffle function stores some byte offset in the textual
representation of the program program at the address indicated by
line. The offset may be indicative of the source position of the next
instruction to be executed, and as well as of the source position of the
instruction whose execution just failed (since instruction pointer is not
advanced for execution failures). The function is intended to help with
determining where and why the program execution failed.
When not able to determine an useful offset, it will store 0 at line.
The function returns 0.
It should be deployed for single function call program execution only. For
step by step program execution consider x1f4_look_shuffle.
See x1f4_look_shuffle.