---

6.14.3.15 x1f4_note_shuffle

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

The x1f4_note_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_note_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 returns 0. Non zero is returned for failure.

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