From 1955dcd47b956da220497c9818c67a8ca58cca35 Mon Sep 17 00:00:00 2001 From: Robert James Kaes Date: Fri, 30 May 2003 16:21:48 +0000 Subject: (vector_getentry): Changed the API to return the data pointer and have the length returned in a argument variable pointer. This should be a more natural way of using the function. --- src/vector.h | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) (limited to 'src/vector.h') diff --git a/src/vector.h b/src/vector.h index 1600ce8..c125e85 100644 --- a/src/vector.h +++ b/src/vector.h @@ -1,4 +1,4 @@ -/* $Id: vector.h,v 1.3 2003-05-29 21:07:22 rjkaes Exp $ +/* $Id: vector.h,v 1.4 2003-05-30 16:21:47 rjkaes Exp $ * * A vector implementation. The vector can be of an arbritrary length, and * the data for each entry is an lump of data (the size is stored in the @@ -55,8 +55,8 @@ extern int vector_append(vector_t vector, void *data, ssize_t len); extern int vector_prepend(vector_t vector, void *data, ssize_t len); /* - * A pointer to the data at position "pos" (zero based) is returned in the - * "data" pointer. If the vector is out of bound, data is set to NULL. + * A pointer to the data at position "pos" (zero based) is returned and the + * size pointer contains the length of the data stored. * * The pointer points to the actual data in the vector, so you have * the power to modify the data, but do it responsibly since the @@ -65,10 +65,12 @@ extern int vector_prepend(vector_t vector, void *data, ssize_t len); * likely mess up the "length" parameter of the data.) However, DON'T * try to realloc or free the data; doing so will break the vector. * - * Returns: negative upon an error - * length of data if position is valid + * If "size" is NULL the size of the data is not returned. + * + * Returns: NULL on error + * valid pointer to data */ -extern ssize_t vector_getentry(vector_t vector, size_t pos, void **data); +extern void* vector_getentry(vector_t vector, size_t pos, size_t* size); /* * Returns the number of enteries (or the length) of the vector. -- cgit v1.2.3