index 93561906b6056a272f468c9c87187469004b8246..28816a6a49abaaf58232f55ab5b7e9a9f6a2ffa8 100644 (file)
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
/*
* 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
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