home *** CD-ROM | disk | FTP | other *** search
/ Aminet 18 / aminetcdnumber181997.iso / Aminet / misc / emu / AROSdev.lha / AROS / workbench / libs / iffparse / collectionchunk.c < prev    next >
Encoding:
C/C++ Source or Header  |  1997-02-03  |  1.7 KB  |  76 lines
  1. /*
  2.     (C) 1995-96 AROS - The Amiga Replacement OS
  3.     $Id: collectionchunk.c,v 1.2 1997/02/03 18:38:01 digulla Exp $
  4.  
  5.     Desc:
  6.     Lang: english
  7. */
  8. #include "iffparse_intern.h"
  9.  
  10. /*****************************************************************************
  11.  
  12.     NAME */
  13. #include <proto/iffparse.h>
  14.  
  15.     AROS_LH3(LONG, CollectionChunk,
  16.  
  17. /*  SYNOPSIS */
  18.     AROS_LHA(struct IFFHandle *, iff, A0),
  19.     AROS_LHA(LONG              , type, D0),
  20.     AROS_LHA(LONG              , id, D1),
  21.  
  22. /*  LOCATION */
  23.     struct Library *, IFFParseBase, 23, IFFParse)
  24.  
  25. /*  FUNCTION
  26.     Installs an entry handler with the given type and id, so that
  27.     chunks encountered with the same type and id will be stored.
  28.     This is quite like PropChunk(), but CollectionChunk() will
  29.     store the contents of multiple chunks with the same type and id.
  30.     To retrieve the stored collection of chunks one uses FindCollection().
  31.     Remember: the collection is only valid inside the current property scope.
  32.  
  33.     INPUTS
  34.     iff   - Pointer to IFFHandle struct. (does not need to be open).
  35.     type  - IFF chunk type declarator for chunk to collect.
  36.     id    -  IFF chunk id identifier for chunk to collect.
  37.  
  38.     RESULT
  39.     error - 0 if successfulle. IFFERR_#? elsewise.
  40.  
  41.     NOTES
  42.  
  43.     EXAMPLE
  44.  
  45.     BUGS
  46.  
  47.     SEE ALSO
  48.     CollectionChunks(), FindCollection, PropChunk
  49.  
  50.     INTERNALS
  51.  
  52.     HISTORY
  53.   27-11-96    digulla automatically created from
  54.       iffparse_lib.fd and clib/iffparse_protos.h
  55.  
  56. *****************************************************************************/
  57. {
  58.     AROS_LIBFUNC_INIT
  59.     AROS_LIBBASE_EXT_DECL(struct Library *,IFFParseBase)
  60.  
  61.     return
  62.     (
  63.     EntryHandler
  64.     (
  65.         iff,
  66.         type,
  67.         id,
  68.         IFFSLI_PROP,
  69.         &(IPB(IFFParseBase)->collectionhook),
  70.         iff
  71.     )
  72.     );
  73.  
  74.     AROS_LIBFUNC_EXIT
  75. } /* CollectionChunk */
  76.