NAME
StopOnExit -- declare a stop condition for exiting a chunk. (V36)
SYNOPSIS
error = StopOnExit(iff, type, id);
D0 A0 D0 D1
long stoponexit(struct iffhandle *, long, long);
FUNCTION
Installs an exit handler for the specified chunk which will cause the
parseiff() function to return control to the caller when this chunk
is exhausted. parseiff() will return ifferr_eoc when the declared
chunk is about to be popped. This is only of value when parseiff()
is called with the IFFPARSE_SCAN control code.
INPUTS
iff - pointer to iffhandle structure (need not be open).
type - type code for chunk to declare (ex. "ILBM").
id - identifier for chunk to declare (ex. "BODY").
RESULT
error - 0 if successful or an IFFERR_#? error code if unsuccessful.
SEE ALSO
parseiff(), <libraries/iffparse.h>