The following are brief descriptions of the IFFParse functions discussed
in this chapter.  IFFParse library functions are avialable in Release 2 of
the Amiga OS and are backward compatible with older versions of the
system.  Further information about these and other IFFParse functions can
be found in the 3rd edition of the Amiga ROM Kernel Reference Manual:
Includes and Autodocs, also from Addison-Wesley.


                  Table 33-2: IFFParse Library Functions
  _______________________________________________________________________
 |                                                                       |
 |            Function              Description                          |
 |=======================================================================|
 |            allociff()  creates an iffhandle structure.                |
 |             freeiff()  frees the iffhandle structure created with     |
 |                        AllocIFF().                                    |
 |             openiff()  initialize an iffhandle structure to read or   |
 |                        write an iff stream.                           |
 |            closeiff()  closes an iff context.                         |
 |-----------------------------------------------------------------------|
 |             initiff()  initialize an iffhandle as a user-defined      |
 |                        stream.                                        |
 |        initiffasdos()  initialize an iffhandle as an amigados stream. |
 |       initiffasclip()  initialize an iffhandle as a clipboard stream. |
 |-----------------------------------------------------------------------|
 |       openclipboard()  create a handle on a clipboard unit for        |
 |                        InitIFFasClip().                               |
 |            parseiff()  parse an iff file from an iffhandle stream.    |
 |      readchunkbytes()  read bytes from current chunk into a buffer.   |
 |    readchunkrecords()  read record elements from the current chunk    |
 |                        into a buffer.                                 |
 |           stopchunk()  declare a chunk that should cause parseiff()   |
 |                        to return.                                     |
 |        currentchunk()  get the context node for the current chunk.    |
 |           propchunk()  specify a property chunk to store.             |
 |            findprop()  search for a stored property in a given        |
 |                        context.                                       |
 |     collectionchunk()  declare a chunk type for collection.           |
 |      findcollection()  get a pointer to the current list of           |
 |                        collection items.                              |
 |          stoponexit()  declare a stop condition for exiting a chunk.  |
 |        entryhandler()  add an entry handler to the iffhandle context. |
 |         exithandler()  add an exit handler to the iffhandle context.  |
 |-----------------------------------------------------------------------|
 |           pushchunk()  push a given context node onto the top of the  |
 |                        context stack.                                 |
 |            popchunk()  pop the top context node off of the context    |
 |                        stack.                                         |
 |        currentchunk()  get the top context node for the current chunk.|
 |         parentchunk()  get the nesting context node for a given chunk.|
 |-----------------------------------------------------------------------|
 |      alloclocalitem()  create a localcontextitem (lci) structure.     |
 |       localitemdata()  returns a pointer to the user data of a        |
 |                        LocalContextItem (LCI).                        |
 |      storelocalitem()  insert a localcontextitem (lci).               |
 |  storeitemincontext()  store a localcontextitem in a given context    |
 |                        node.                                          |
 |     findpropcontext()  find the property context for the current      |
 |                        state.                                         |
 |       findlocalitem()  return a localcontextitem from the context     |
 |                        stack.                                         |
 |       freelocalitem()  free a localcontextitem (lci) created with     |
 |                        AllocLocalItem().                              |
 |   setlocalitempurge()  set purge vector for a local context item.     |
 |_______________________________________________________________________|