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


NAME
    CollectionChunk -- declare a chunk type for collection.

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

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

FUNCTION
    Installs an entry handler for chunks with the given type and id so
    that the contents of those chunks will be stored as they are
    encountered.  This is like propchunk() except that more than one
    chunk of this type can be stored in lists which can be returned by
    findcollection().  the storage of these chunks still follows the
    property chunk scoping rules for IFF files so that at any given
    point, stored collection chunks will be valid in the current context.

INPUTS
    iff     - pointer to iffhandle struct (does not need to be open).
    type    - type code for the chunk to declare (ex. "ILBM").
    id      - identifier for the chunk to declare (ex. "CRNG").

RESULT
    error   - 0 if successful or an IFFERR_#? error code if not
              successful.

EXAMPLE

NOTES

BUGS

SEE ALSO
    collectionchunks(), findcollection(), propchunk()