---

6.14.3.11 x1f4_long_shuffle

extern int x1f4_long_shuffle
    (void *program, void *context, int *note, void *back,
     int (*call)(void *), void *output);

The x1f4_long_shuffle function executes the program program in the context execution context. After each successfully expression evaluation it tests the int stored at note and upon non zero find it calls the call routine, passing it back as its only argument. If the routine evaluates zero, the x1f4_long_shuffle function resets the int stored at note and continues with the program execution, otherwise it immediately returns non zero.

See Procedural Program Execution.

A non zero return of the call routine may be examined against the defined error classes and recovered later, depending on its value and whether error trapping mechanisms have been installed.

See Error Classes.

See Limiting The Scope Of Errors.

If successful, the function stores the evaluation result of the ‘main’ function return statement at the address indicated by output and returns 0. Non zero is returned for failure.

See Procedural Language Syntax.

The context evaluation context is passed as the first argument to function and operator logic evaluation routines. It is otherwise not interpreted.