vector.h

#ifndef _SYSIO_VECTOR_H_
#define _SYSIO_VECTOR_H_

#include <sysio/defs.h>
#ifdef __cplusplus
  extern "C" {
#endif
/* ========================================================================== */

/* macros =================================================================== */

/* types ==================================================================== */

typedef void * (*vVectorElmtNew) (void);

typedef void (*vVectorElmtDestroy) (void *data);

typedef int (*iVectorElmtMatch) (const void *key1, const void *key2);

typedef const void * (*pvVectorElmtKey) (const void * element);

/* structures =============================================================== */
typedef struct xVector {
  void** data; 
  int size; 
  int alloc; 
  int growth; 
  union {
    uint16_t flag;
    struct {
      uint16_t malloc: 1; 
    };
  };
  vVectorElmtNew       fnew;
  vVectorElmtDestroy   fdestroy;
  pvVectorElmtKey      fkey;
  iVectorElmtMatch     fmatch;
} xVector;

/* internal public functions ================================================ */

int iVectorInit (xVector * vector, int growth, vVectorElmtNew fnew, vVectorElmtDestroy fdestroy);

int iVectorInitSearch (xVector *vector, pvVectorElmtKey fkey, iVectorElmtMatch fmatch);

int iVectorSize (const xVector * vector);

int iVectorResize (xVector * vector, int new_size);

void vVectorDestroy (xVector * vector);

int iVectorClear (xVector * vector);

int iVectorAppend (xVector * vector, void * data);

void * pvVectorGet (const xVector * vector, int index);

int iVectorRemove (xVector * vector, int index);

int iVectorReplace (xVector * vector, int index, void * data);

void * pvVectorFindFirst (const xVector * vector, const void * key);

int iVectorFindFirstIndex (const xVector * vector, const void * key);

/* ========================================================================== */
#ifdef __cplusplus
  }
#endif
#endif /*_SYSIO_VECTOR_H_ defined */