89 lines
2.2 KiB
C
89 lines
2.2 KiB
C
#ifndef VECTOR_H_
|
|
#define VECTOR_H_
|
|
|
|
typedef struct _vector vector;
|
|
typedef void (*mapCallback) (void *object);
|
|
|
|
/**
|
|
* Creates a new vector.
|
|
*
|
|
* @return A pointer to the newly created vector on success; otherwise NULL.
|
|
*/
|
|
vector *vectorCreate(void);
|
|
|
|
/**
|
|
* Destroys the vector v. This is done by first calling the destroy callback
|
|
* function on each element in the vector then free'ing the vector itself.
|
|
*
|
|
* @param v The vector to destroy.
|
|
*/
|
|
void vectorDestroy(vector *v);
|
|
|
|
/**
|
|
* Adds object to the vector v.
|
|
*
|
|
* @param v The vector to add the object onto.
|
|
* @param object The object to add.
|
|
* @return A pointer to object.
|
|
*/
|
|
void *vectorAdd(vector *v, void *object);
|
|
|
|
/**
|
|
* Returns a pointer to the object at offset index for the vector v.
|
|
*
|
|
* @param v The vector to return the item from.
|
|
* @param index The index of the desired item.
|
|
* @return A pointer to the object/item, or NULL if no such item exists.
|
|
*/
|
|
void *vectorAt(vector *v, int index);
|
|
|
|
/**
|
|
* A convenience method that returns the most recently added item to the vector
|
|
* v. It is functionally equivalent to: vectorAt(v, vectorSize(v)).
|
|
*
|
|
* @param v The vector to return the last item of.
|
|
* @return The last item in the vector.
|
|
*/
|
|
void *vectorHead(vector *v);
|
|
|
|
/**
|
|
*
|
|
*/
|
|
void *vectorSetAt(vector *v, int index, void *object);
|
|
|
|
/**
|
|
* Removes the item at index from the vector v.
|
|
*
|
|
* @param v The vector to remove the item from.
|
|
* @param index The index of the item to remove.
|
|
*/
|
|
void vectorRemoveAt(vector *v, int index);
|
|
|
|
/**
|
|
* Iterates through each item in the vector v calling cb(vectorAt(v, index)).
|
|
*
|
|
* @param v The vector to map/iterate over.
|
|
* @param cb The function to call.
|
|
*/
|
|
void vectorMap(vector *v, mapCallback cb);
|
|
|
|
/**
|
|
* Invokes vectorMap(v, cb) followed by vectorDestroy(v). This allows for the
|
|
* elements in the vector to be free'ed/destroyed in order to prevent memory
|
|
* leaks.
|
|
*
|
|
* @param v The vector to map over and destroy.
|
|
* @param cb The function to call.
|
|
*/
|
|
void vectorMapAndDestroy(vector *v, mapCallback cb);
|
|
|
|
/**
|
|
* Returns the number of elements in the vector v.
|
|
*
|
|
* @param v The vector to get the number of elements of.
|
|
* @return The number of elements in the vector.
|
|
*/
|
|
int vectorSize(vector *v);
|
|
|
|
#endif /*VECTOR_H_*/
|