add failing sort testlichen-c

1 files changed, 4 insertions, 1 deletions

diff --git a/lichen.h b/lichen.h
index 5f13e85..3a8cce9 100644
--- a/lichen.h
+++ b/lichen.h
@@ -49,10 +49,13 @@ typedef struct li_ll_t {
 struct li_ll_t * li_alloc_ll();
 // free a linked list
 void li_free_ll(struct li_ll_t *list, void (*free_data)(void*));
+// prepend and append to a linked list
 int li_ll_append(struct li_ll_t *list, void *data);
 int li_ll_prepend(struct li_ll_t *list, void *data);
+// copy a linked list. !!! WARNING !!! if this function fails (returns nonzero) you MUST call li_free_ll on dst yourself!
 int li_copy_list(struct li_ll_t **dst, struct li_ll_t *src, void *(*copy_data)(void*));
-
+// sort a list. compare_data should return a positive, negative or zero value of the same sign as (a-b)
+int li_sort_list(struct li_ll_t *list, int (*compare_data)(void *, void*));