tools/dtdesc/c_iff/openiff.c

   1 /*
   2  *  c_iff - a portable IFF-parser
   3  *
   4  *  Copyright (C) 2000, 2001 Joerg Dietrich
   5  *
   6  *  This is the AROS-version of c_iff.
   7  *  It is distributed under the AROS Public License.
   8  *  But I reserve the right to distribute
   9  *  my own version under other licenses.
  10  */
  11
  12 /*
  13  *  openiff.c - open an existing IFF
  14  */
  15
  16 #include "c_iff.h"
  17
  18 /****** c_iff/OpenIFF *******************************************************
  19 *
  20 *   NAME
  21 *       OpenIFF -- Open an existing IFF-file for reading
  22 *
  23 *   SYNOPSIS
  24 *       TheHandle = NewIFF( Name )
  25 *
  26 *       struct IFFHandle *NewIFF( char * )
  27 *
  28 *   FUNCTION
  29 *       This is your function, if you want to read an existing IFF-file.
  30 *       It opens the existing file, allocates the IFFHandle and reads
  31 *       and confirms the IFF-header.
  32 *
  33 *   INPUTS
  34 *       Name        - name of the IFF-file to be opened
  35 *
  36 *   RESULT
  37 *       TheHandle   - IFFHandle to read from
  38 *
  39 *   EXAMPLE
  40 *
  41 *   NOTES
  42 *       IFF-files opened with OpenIFF() must be closed with CloseIFF() .
  43 *
  44 *   BUGS
  45 *
  46 *   SEE ALSO
  47 *       CloseIFF()
  48 *
  49 *****************************************************************************
  50 *
  51 *       Private notes:
  52 */
  53
  54 struct IFFHandle *OpenIFF(char *Name)
  55 {
  56  struct IFFHandle *Ret;
  57
  58  if(!Name)
  59  {
  60   return(NULL);
  61  }
  62
  63  Ret=(struct IFFHandle *) malloc(sizeof(struct IFFHandle));
  64  if(!Ret)
  65  {
  66   return(NULL);
  67  }
  68
  69  Ret->TheFile=NULL;
  70  Ret->TheFile=fopen(Name, "rb");
  71  if(!Ret->TheFile)
  72  {
  73   free((void *) Ret);
  74   return(NULL);
  75  }
  76
  77  Ret->IFFType=0;
  78  if(!CheckIFF(Ret))
  79  {
  80   fclose(Ret->TheFile);
  81   free((void *) Ret);
  82   return(NULL);
  83  }
  84
  85  Ret->ChunkID=INVALID_ID;
  86  Ret->BytesLeftInChunk=0;
  87  Ret->NewIFF=FALSE;
  88  Ret->IFFSize=0;
  89  Ret->LastNode=NULL;
  90
  91  return(Ret);
  92 }
  93
  94