-#include <string.h>
-#include <stdlib.h>
+#include <string.h> // for memmove, memcpy
+#include <stdlib.h> // for malloc, realloc, free, qsort
#include "array.h"
-Array array_create(size_t membsiz)
+void array_ini(Array *array, size_t mbs, size_t ext, ArrayComparator cmp)
{
- return (Array) {
- .membsiz = membsiz,
- .siz = 0,
- .cap = 0,
- .ptr = NULL,
- };
+ array->mbs = mbs;
+ array->ext = ext;
+ array->cmp = cmp;
+ array->siz = 0;
+ array->cap = 0;
+ array->ptr = NULL;
}
+void array_rlc(Array *array)
+{
+ array->ptr = realloc(array->ptr, array->cap * array->mbs);
+}
-static void array_realloc(Array *array)
+void array_grw(Array *array, size_t n)
{
+ array->siz += n;
+
if (array->siz > array->cap) {
- array->cap = array->siz + DRAGONSTD_ARRAY_REALLOC_EXTRA;
- array->ptr = realloc(array->ptr, array->cap * array->membsiz);
+ array->cap = array->siz + array->ext;
+ array_rlc(array);
}
}
-static void array_alloc(Array *array, size_t siz)
+void array_shr(Array *array, size_t n)
{
- array->siz += siz;
- array_realloc(array);
+ array->siz -= n;
+
+ if (array->cap > array->siz) {
+ array->cap = array->siz;
+ array_rlc(array);
+ }
}
-void array_insert(Array *array, void *elem, size_t idx)
+void array_put(Array *array, const void *ptr, size_t n)
{
size_t oldsiz = array->siz;
- array_alloc(array, 1);
+ array_grw(array, 1);
- char *iptr = (char *) array->ptr + idx * array->membsiz;
- memmove(iptr + array->membsiz, iptr, (oldsiz - idx) * array->membsiz);
- memcpy(iptr, elem, array->membsiz);
+ char *iptr = array->ptr + n * array->mbs;
+ memmove(iptr + array->mbs, iptr, (oldsiz - n) * array->mbs);
+ memcpy(iptr, ptr, array->mbs);
}
-void array_append(Array *array, void *elem)
+void array_add(Array *array, const void *ptr)
{
size_t oldsiz = array->siz;
- array_alloc(array, 1);
+ array_grw(array, 1);
- memcpy((char *) array->ptr + oldsiz * array->membsiz, elem, array->membsiz);
+ memcpy(array->ptr + oldsiz * array->mbs, ptr, array->mbs);
}
-void array_copy(Array *array, void **ptr, size_t *count)
+void array_cpy(Array *array, void **ptr, size_t *n)
{
- *count = array->siz;
- size_t size = array->siz * array->membsiz;
+ *n = array->siz;
+ size_t size = array->siz * array->mbs;
*ptr = malloc(size);
memcpy(*ptr, array->ptr, size);
}
+
+void array_cln(Array *dst, Array *src)
+{
+ array_ini(dst, src->mbs, src->ext, src->cmp);
+ array_cpy(src, &dst->ptr, &dst->siz);
+ dst->cap = dst->siz;
+}
+
+void array_rcy(Array *array)
+{
+ array->siz = 0;
+}
+
+void array_del(Array *array)
+{
+ if (array->ptr)
+ free(array->ptr);
+}
+
+void array_srt(Array *array)
+{
+ qsort(array->ptr, array->siz, array->mbs, array->cmp);
+}
+
+ssize_t array_fnd(Array *array, const void *ptr, size_t *idx)
+{
+ size_t low, high, mid;
+
+ low = 0;
+ high = array->siz;
+
+ while (low < high) {
+ mid = (low + high) / 2;
+
+ int cmp = array->cmp(ptr, array->ptr + mid * array->mbs);
+
+ if (cmp == 0)
+ return idx ? (*idx = mid) : mid;
+ else if (cmp < 0)
+ high = mid;
+ else // (cmp > 0)
+ low = mid + 1;
+ }
+
+ if (idx)
+ *idx = low;
+
+ return -1;
+}
+
+size_t array_ins(Array *array, const void *ptr)
+{
+ size_t n;
+
+ array_fnd(array, ptr, &n);
+ array_put(array, ptr, n);
+
+ return n;
+}
-#ifndef _DRAGONSTD_ARRAY_H_
+/*
+ +-------+
+ | ARRAY |
+ +-------+
+
+ +-----------+--------------------+---------------------------------------+
+ | Operation | Average complexity | Notes |
+ +-----------+--------------------+-------------------------------------- +
+ | Lookup | O(1) | |
+ | Append | O(1) | unpredictable if capacity is exceeded |
+ | Insert | O(n) | unpredictable if capacity is exceeded |
+ | Sort | O(n log n) | |
+ | Find | O(log n) | |
+ +-----------+--------------------+---------------------------------------+
+
+ An array is a data structure where all elements (members) have the same size and are
+ located consecutively in memory.
+
+ Each array has a size which holds the number of current elements of the array.
+ It also has a capacity, which is the number of elements that currently fit into
+ the array, which may be bigger than size.
+
+ The lookup complexity is O(1), which makes arrays well suited for fast lookups.
+
+ The complexity for appending an element at the end of the array is O(1).
+
+ The complexity for inserting an element at an arbitrary index of the array is O(n),
+ where n is the length of the array. This is because memory may need to be moved.
+
+ However, the insert/append complexity becomes unpredictable and largely depends on
+ the implementation of the C library if the capacity is exceeded. If the capacity
+ needs to be extended, the memory is reallocated. The mentioned complexity rules
+ only apply as long as (cap > siz + 1). *Usually*, realloc will have a complexity
+ of either O(1), if the memory block happens to be already big enough, or
+ O(n) + X, if a new, bigger block needs to be allocated and the memory copied.
+
+ Note that when the capacity is extended, it is possible to allocated more space space
+ than needed, to prevent frequent calls to append/insert from having to reallocate
+ the memory every time. If, and if yes how much additional space is allocated is
+ determined by the extra space field. Extra space for ext elements is allocated
+ whenever a growth reallocation happens.
+
+ The array can be sorted. In this case, the array is expected to have a comparator cmp
+ that is not NULL.
+
+ The comparison function must return an integer less than, equal to, or greater than
+ zero if the first argument is considered to be respectively less than, equal to,
+ or greater than the second. If two members compare as equal, their order in the
+ sorted array is undefined. [Copied from the Linux man-pages]
+
+ The sorting function uses the quicksort algorithm from the C library, which has an
+ average complexity of O(n log n).
+
+ To maintain the order of a sorted array, add and put should not be used.
+*/
+
+#ifndef _DRAGONSTD_ARRAY_H_ // include guard
#define _DRAGONSTD_ARRAY_H_
-#ifndef DRAGONSTD_ARRAY_REALLOC_EXTRA
-#define DRAGONSTD_ARRAY_REALLOC_EXTRA 25
-#endif
+#include <stddef.h> // for size_t
+#include <sys/types.h> // for ssize_t
-#include <stddef.h>
-#include <stdbool.h>
+typedef int (*ArrayComparator)(const void *va, const void *vb);
-typedef struct
-{
- size_t membsiz;
- size_t siz, cap;
- void *ptr;
+typedef struct {
+ /* public */
+ void *ptr; // memory
+ size_t ext; // extra space
+ ArrayComparator cmp; // comparator
+ /* private */
+ size_t mbs; // member size
+ size_t siz; // used space
+ size_t cap; // available space
} Array;
-Array array_create(size_t membsiz);
-void array_insert(Array *array, void *elem, size_t idx);
-void array_append(Array *array, void *elem);
-void array_copy(Array *array, void **ptr, size_t *count);
+void array_ini(Array *array, size_t mmb, size_t ext, ArrayComparator cmp);
+/*
+ Initializes the array.
+
+ The array will have the member size of mmb and the extra space set to ext.
+ mmb should be bigger than 0 and may not be changed after the initialization.
+ ext can be 0 or bigger and may be changed any time.
+ The comparator of the array is set to cmp and may be nil.
+
+ This function should be called before calling any other functions on the
+ array.
+
+ This function should not be called on an array that has been initialized before,
+ unless the array either has a capacity of 0 or it has been deleted using
+ array_del. Otherwise a memory leak will occur.
+*/
+
+void array_rlc(Array *array);
+/*
+ Reallocates the array's memory to match it's capacity.
+
+ This function should be called every time the capacity has changed.
+*/
+
+void array_grw(Array *array, size_t n);
+/*
+ Grows the array by n bytes.
+
+ This function increases the arrays size by n bytes. If this exceeds the capacity of
+ the array, the capacity set to the size and the extra space ext is added to it.
+
+ If the capacity is changed, the array is reallocated.
+
+ If n is zero, the array's capacity may still grow by extra space if it exactly
+ matches the current size.
+*/
+
+void array_shr(Array *array, size_t n);
+/*
+ Shrinks the array by n bytes.
+
+ This function decreases the arrays size by n bytes.
+
+ If the array has additional capacity left after it has been shrunk, the capacity
+ is set to the new size and the array is reallocated to fit the new capacity.
+ For n > 0, this is always the case, for n = 0, this may be the case.
+
+ Note that calling this function with n = 0 is useful to shrink the array's memory to
+ exactly fit it's used size.
+*/
+
+void array_put(Array *array, const void *ptr, size_t n);
+/*
+ Grows the array by 1 and inserts ptr at the index n.
+
+ This function inserts the memory pointed to by ptr before the array member at
+ index n, moving all elements from that index to the end of the array.
+
+ After this operation, the inserted element will be _at_ the index n.
+
+ The memory that ptr points to, which's size is assumed to be at least as big as the
+ array's member size is copied into the arrays memory.
+
+ n should be in the range from 0 to the array's size.
+*/
+
+void array_add(Array *array, const void *ptr);
+/*
+ Grows the array by 1 and appends ptr at the end of the array.
+
+ This function's result is equivalent to calling array_put(array, ptr, array->siz),
+ but it is slightly faster since it saves unnecessary calls.
+*/
+
+void array_cpy(Array *array, void **ptr, size_t *n);
+/*
+ Allocates a buffer big enough to fit the array's used size.
+ Copies the array's contents into the allocated buffer.
+ Returns the buffer in ptr and the size in n.
+
+ Note that the returned size is the number of elements, not the number of bytes.
+*/
+
+void array_cln(Array *dst, Array *src);
+/*
+ Clones the array src to the array dst.
+
+ dst is initialized to have the same configuration (member size, extra space,
+ comparator) as src.
+
+ After the operation, the contents of the array dst are be the same as those of src.
+ The size of dst and src are the same, the capacity of dst however is the same as
+ the size of dst and src (which might not equal the capacity of src).
+
+ Since array_ini is called on dst, it should be uninitialized, empty or deleted.
+*/
+
+void array_rcy(Array *array);
+/*
+ Recycles the array.
+
+ This function sets the used size of the array to 0 but leaves the capacity unchanged.
+ The array's memory is not free'd and the array can be reused.
+*/
+
+void array_del(Array *array);
+/*
+ Deletes the array.
+
+ This function frees the arrays memory. If this is not called when the array's
+ reference is dropped, a memory leak occurs, unless the array is empty (capacity
+ of 0), in which case the function does not need to be called. The function works
+ fine on empty arrays however.
+
+ After this, the array should no longer be used until reinitialized.
+*/
+
+void array_srt(Array *array);
+/*
+ Sorts the array using the quicksort algorithm.
+
+ The array is assumed to have a non-NULL comparator.
+ Wraps the qsort C-library routine. Please refer to it's documentation.
+*/
+
+ssize_t array_fnd(Array *array, const void *ptr, size_t *idx);
+/*
+ Searches the sorted array for the element ptr.
+ Returns the index of the element, or -1 if it wasn't found.
+
+ If idx is not NULL, a pointer to the last searched index is saved to where it
+ points to. This is the index ptr would need to be inserted at to keep the order.
+
+ It is assumed that the array has been sorted by array_srt before (or was empty),
+ and the order has been kept and the comparator has not been changed since.
+*/
+
+size_t array_ins(Array *array, const void *ptr);
+/*
+ Inserts an element into a sorted array, keeping the order.
+ Returns the index the element has been inserted at.
+
+ Calls array_fnd and array_put.
+
+ It is assumed that the array has been sorted by array_srt before (or was empty),
+ and the order has been kept and the comparator has not been changed since.
+*/
-#endif
+#endif // _DRAGONSTD_ARRAY_H_
--- /dev/null
+#include <stdio.h>
+#include <stdlib.h>
+#include <assert.h>
+#include <time.h>
+#include "../array.h"
+
+int cmp_int(const int *pa, const int *pb)
+{
+ return *pa - *pb;
+}
+
+void assert_in_order(Array *arr)
+{
+ for (size_t i = 1; i < arr->siz; i++)
+ assert(((int *) arr->ptr)[i - 1] <= ((int *) arr->ptr)[i]);
+}
+
+void dump(Array *arr)
+{
+ for (size_t i = 0; i < arr->siz; i++) {
+ printf("%d", ((int *) arr->ptr)[i]);
+
+ if (i != arr->siz - 1)
+ printf(",");
+ }
+}
+
+int main()
+{
+ int i;
+ Array arr, arr2;
+ srand(time(0));
+
+ printf("testing ini\n");
+ array_ini(&arr, sizeof(int), 0, NULL);
+
+ printf("testing add\n");
+ i = 1; array_add(&arr, &i);
+ i = 3; array_add(&arr, &i);
+ i = 4; array_add(&arr, &i);
+
+ printf("testing put\n");
+ i = 2; array_put(&arr, &i, 1);
+ i = 5; array_put(&arr, &i, arr.siz);
+
+ printf("testing siz: exp: 5 got: %lu\n", arr.siz);
+ assert(arr.siz == 5);
+
+ printf("testing cap: exp: 5 got: %lu\n", arr.cap);
+ assert(arr.cap == 5);
+
+ printf("testing contents: exp: 1,2,3,4,5 got: "); dump(&arr); printf("\n");
+ for (size_t j = 0; j < arr.siz; j++)
+ assert((size_t) ((int *) arr.ptr)[j] == j + 1);
+
+ printf("testing cln\n");
+ array_cln(&arr2, &arr);
+
+ printf("testing equality: exp: "); dump(&arr); printf(" got: "); dump(&arr2);
+ printf("\n");
+
+ for (size_t j = 0; j < arr.siz; j++)
+ assert(((int *) arr.ptr)[j] == ((int *) arr2.ptr)[j]);
+
+ printf("testing del\n");
+ array_del(&arr);
+ array_del(&arr2);
+
+ printf("testing ini after del\n");
+ array_ini(&arr, sizeof(int), 5, (void *) &cmp_int);
+
+ printf("testing cap: exp: 0 got: %lu\n", arr.cap);
+ assert(arr.cap == 0);
+
+ printf("testing overallocation\n");
+ i = 50; array_add(&arr, &i);
+
+ printf("testing cap: exp: 0 got: %lu\n", arr.cap);
+ assert(arr.siz == 1);
+
+ printf("testing cap: exp: 6 got: %lu\n", arr.cap);
+ assert(arr.cap == 6);
+
+ for (int j = 0; j < 7; j++) {
+ i = rand() % 100; array_add(&arr, &i);
+ }
+
+ printf("testing siz: exp: 8 got: %lu\n", arr.cap);
+ assert(arr.siz == 8);
+
+ printf("testing cap: exp: 12 got: %lu\n", arr.cap);
+ assert(arr.cap == 12);
+
+ printf("testing grw\n");
+ array_grw(&arr, 5);
+
+ printf("testing siz: exp: 13 got: %lu\n", arr.cap);
+ assert(arr.siz == 13);
+
+ printf("testing cap: exp: 18 got: %lu\n", arr.cap);
+ assert(arr.cap == 18);
+
+ printf("testing shr\n");
+ array_shr(&arr, 5);
+
+ printf("testing siz: exp: 8 got: %lu\n", arr.cap);
+ assert(arr.siz == 8);
+
+ printf("testing cap: exp: 8 got: %lu\n", arr.cap);
+ assert(arr.cap == 8);
+
+ printf("testing srt\n");
+ array_srt(&arr);
+
+ printf("testing order: exp: (sorted) got: "); dump(&arr); printf("\n");
+ assert_in_order(&arr);
+
+ for (size_t j = 0; j < arr.siz; j++) {
+ i = ((int *) arr.ptr)[j]; ssize_t s = array_fnd(&arr, &i, NULL);
+
+ printf("testing fnd at index %lu: exp: >=0 got: %ld\n", j, s);
+ assert(s >= 0);
+
+ int k = ((int *) arr.ptr)[s];
+
+ printf("testing fnd at index %lu: exp: %d got: %d\n", j, i, k);
+ assert(k == i);
+ }
+
+ printf("testing ins\n");
+ for (int j = 0; j < 10; j++) {
+ i = rand() % 100; array_ins(&arr, &i);
+ }
+
+ printf("testing order: exp: (sorted) got: "); dump(&arr); printf("\n");
+ assert_in_order(&arr);
+
+ array_del(&arr);
+}