[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   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>