workbench/libs/iffparse/findcollection.c

   1 /*
   2     Copyright © 1995-2004, The AROS Development Team. All rights reserved.
   3     $Id$
   4 */
   5
   6 #include "iffparse_intern.h"
   7
   8 /*****************************************************************************
   9
  10     NAME */
  11 #include <proto/iffparse.h>
  12
  13         AROS_LH3(struct CollectionItem *, FindCollection,
  14
  15 /*  SYNOPSIS */
  16         AROS_LHA(struct IFFHandle *, iff, A0),
  17         AROS_LHA(LONG              , type, D0),
  18         AROS_LHA(LONG              , id, D1),
  19
  20 /*  LOCATION */
  21         struct Library *, IFFParseBase, 27, IFFParse)
  22
  23 /*  FUNCTION
  24         Returns a pointer to a list of CollectionItems the installed
  25         CollectionChunk of that type and ID.
  26
  27     INPUTS
  28         iff   - pointer to an IFFHandle struct.
  29         type  - type code to search for.
  30         id    -  id code to search for.
  31
  32
  33     RESULT
  34         ci - pointer to the last collection chunk encountered
  35              with pointers to previous ones.
  36
  37     NOTES
  38
  39     EXAMPLE
  40
  41     BUGS
  42
  43     SEE ALSO
  44         CollectionChunk(), CollectionChunks()
  45
  46     INTERNALS
  47
  48 *****************************************************************************/
  49 {
  50     AROS_LIBFUNC_INIT
  51     AROS_LIBBASE_EXT_DECL(struct Library *,IFFParseBase)
  52
  53     struct LocalContextItem *lci;
  54
  55     DEBUG_FINDCOLLECTION(dprintf("FindCollection: iff 0x%lx type 0x%08lx (%c%c%c%c) id 0x%08lx (%c%c%c%c)\n",
  56                             iff, type, dmkid(type), id, dmkid(id)));
  57
  58     if (!(lci = FindLocalItem(
  59                 iff,
  60                 type,
  61                 id,
  62                 IFFLCI_COLLECTION)))
  63     {
  64         DEBUG_FINDCOLLECTION(dprintf("FindCollection: return NULL\n"));
  65         return NULL;
  66     }
  67
  68     /* The userdata of the found LCI contains a struct CIPtr,
  69     which is just a pointer to the first CollectionItem  */
  70
  71    return
  72    (
  73        ((struct CIPtr*)LocalItemData(lci) )->FirstCI
  74    );
  75
  76
  77     AROS_LIBFUNC_EXIT
  78 } /* FindCollection */