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


   NAME
        StopChunk -- declare a chunk which should cause parseiff to return.
                     (V36)

   SYNOPSIS
        error = StopChunk(iff, type, id);
        D0                A0   D0    D1

        long stopchunk(struct iffhandle *, long, long);           type;

   FUNCTION
        Installs an entry handler for the specified chunk which will cause
        the parseiff() function to return control to the caller when this
        chunk is encountered. 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
        stopchunks(), parseiff(), <libraries/iffparse.h>