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


NAME
    StopOnExit -- Declare a stop condition for exiting a chunk.

SYNOPSIS
    error = StopOnExit (iff, type, id)
     d0                 a0    d0   d1

    LONG             error;
    struct iffhandle *iff;
    LONG             type;
    LONG             id;

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 struct (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 not
              successful.

EXAMPLE

NOTES

BUGS

SEE ALSO
    parseiff()