X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=src%2Finclude%2Futils%2Fllist.h;h=28816a6a49abaaf58232f55ab5b7e9a9f6a2ffa8;hb=ed569e21915fe71ead292582a8699d25234cf303;hp=93561906b6056a272f468c9c87187469004b8246;hpb=8fae96642304f80a5ce343626970b1cff87123f2;p=sysdb.git diff --git a/src/include/utils/llist.h b/src/include/utils/llist.h index 9356190..28816a6 100644 --- a/src/include/utils/llist.h +++ b/src/include/utils/llist.h @@ -56,6 +56,14 @@ sdb_llist_create(void); void sdb_llist_destroy(sdb_llist_t *list); +/* + * sdb_llist_clear: + * Remove all elements from the list, releasing the included objects + * (decrement the ref-count). + */ +void +sdb_llist_clear(sdb_llist_t *list); + /* * sdb_llist_clone: * Clone an existing list. The objects stored in the list will not be copied @@ -157,9 +165,9 @@ sdb_llist_search_by_name(sdb_llist_t *list, const char *key); /* * sdb_llist_remove: - * Removes and returns the first matchin element of the list. The ref-count of - * the item will not be changed, that is, if the element will not be used any - * further, it should be de-referenced by the caller. + * Removes and returns the first matching element of the list. The ref-count + * of the item will not be changed, that is, if the element will not be used + * any further, it should be de-referenced by the caller. * * Returns: * - a pointer to the first matching object @@ -169,6 +177,19 @@ sdb_object_t * sdb_llist_remove(sdb_llist_t *list, sdb_llist_lookup_cb lookup, const void *user_data); +/* + * sdb_llist_remove_by_name: + * Removes and returns the first element whose name matches the specified key. + * The ref-count of the item will not be changed, that is, if the element will + * not be used any further, it should be de-referenced by the caller. + * + * Returns: + * - a pointer to the first matching object + * - NULL else + */ +sdb_object_t * +sdb_llist_remove_by_name(sdb_llist_t *list, const char *key); + /* * sdb_llist_shift: * Removes and returns the first element of the list. The ref-count of the