/*
   This file was derived from the libwww code, version 2.15, from CERN.
   A number of modifications have been made by Spyglass.

   eric@spyglass.com
 */

/*                                                HTChunk: Flexible array handling for libwww
   CHUNK HANDLING:
   FLEXIBLE ARRAYS

   This module implements a flexible array. It is a general utility module. A chunk is a
   structure which may be extended.  These routines create and append data to chunks,
   automatically reallocating them as necessary.

 */
typedef struct
{
	int size;					/* In bytes                     */
	int growby;					/* Allocation unit in bytes     */
	int allocated;				/* Current size of *data        */
	char *data;					/* Pointer to malloced area or 0 */
}
HTChunk;


/*

   Create new chunk

   ON ENTRY,

   growby                  The number of bytes to allocate at a time when the chunk is
   later extended. Arbitrary but normally a trade-off time vs.
   memory

   ON EXIT,

   returns                 A chunk pointer to the new chunk,

 */

extern HTChunk *HTChunkCreate(int growby);


/*

   Free a chunk

   ON ENTRY,

   ch                      A valid chunk pointer made by HTChunkCreate()

   ON EXIT,

   ch                      is invalid and may not be used.

 */

extern void HTChunkFree(HTChunk * ch);


/*

   Clear a chunk

   ON ENTRY,

   ch                      A valid chunk pointer made by HTChunkCreate()

   ON EXIT,

   *ch                     The size of the chunk is zero.

 */

extern void HTChunkClear(HTChunk * ch);

/*

   Append a character to a  chunk

   ON ENTRY,

   ch                      A valid chunk pointer made by HTChunkCreate()

   c                       The character to be appended

   ON EXIT,

   *ch                     Is one character bigger

 */
extern int HTChunkPutc(HTChunk * ch, char c);

/*

   Determine whether the chunk is terminated or not

   ON ENTRY,

   ch                      A valid chunk pointer made by HTChunkCreate()
   

   ON EXIT,

   int						whether the chunk is terminated or not

 */


extern int HTIsChunkTerminated(HTChunk * ch);

/*

   Append a string to a  chunk

   ON ENTRY,

   ch                      A valid chunk pointer made by HTChunkCreate()

   str                     Tpoints to a zero-terminated string to be appended

   ON EXIT,

   *ch                     Is bigger by strlen(str)

 */


extern void HTChunkPuts(HTChunk * ch, const char *str);


/*

   Append a zero character to a  chunk

 */

/*

   ON ENTRY,

   ch                      A valid chunk pointer made by HTChunkCreate()

   ON EXIT,

   *ch                     Is one character bigger

 */


extern void HTChunkTerminate(HTChunk * ch);

/*

   end */