acp_data.c

   File         : acp_data.c
   Description  : Active C Page Name/void * Data Structure
   Category     : ACP Scripting
   Author       : Charles Yates
  
   This structure is used to propogate collections of name/void * pairs around
   the system. 

   ACPDATA DLLEXP ACPDATA_Init()
 
   Function     : ACPDATA_Init
   Description  : Creates an active c page data environment
   Input        : void
   Output       : void
   Returns      : ACPDATA - an empty acp data environment

   int DLLEXP ACPDATA_Set( ACPDATA env, char *name, void *value )
 
   Function     : ACPDATA_Set
   Description  : Appends or updates the name=value pair in the environment
   Input        : ACPDATA env - environment to update
                  char *name - property name
                  void *value - property value
   Output       : void
   Returns      : int - 0 is success, <> 0 is failure

   int DLLEXP ACPDATA_Count( ACPDATA env )
 
   Function     : ACPDATA_Count
   Description  : Returns the number of name/value pairs in the environment
   Input        : ACPDATA env - environment to query
   Output       : void
   Returns      : int - number of name value pairs

   void * DLLEXP ACPDATA_Get( ACPDATA env, char *name )
 
   Function     : ACPDATA_Get
   Description  : Returns value associated to name
   Input        : ACPDATA env - environment to query
                  char *name - name of property
   Output       : void
   Returns      : char * - address of value

   char * DLLEXP ACPDATA_GetName( ACPDATA env, int index )
 
   Function     : ACPDATA_GetName
   Description  : Gets name at index
   Input        : ACPDATA env - environment to query
                  int index - index to query
   Output       : void
   Returns      : char * - address of name at index [or NULL if not found]

   void * DLLEXP ACPDATA_GetValue( ACPDATA env, int index )
 
   Function     : ACPDATA_GetValue
   Description  : Gets value at index
   Input        : ACPDATA env - environment to query
                  int index - index to query
   Output       : void
   Returns      : char * - address of value at index [or NULL if not found]

   int DLLEXP ACPDATA_Find( ACPDATA env, char *name )
 
   Function     : ACPDATA_Find
   Description  : Retrns the index containing name
   Input        : ACPDATA env - environment to query
                  char *name - name to find
   Output       : void
   Returns      : int - location of name in the environment

   void DLLEXP ACPDATA_Close( ACPDATA env )
 
   Function     : ACPDATA_Close
   Description  : Closes the environment
   Input        : ACPDATA env - environment to close
   Output       : env is closed
   Returns      : void