Lines Matching refs:list
10 * $Id: list.h 11709 2011-01-19 13:48:47Z jordan $
27 /** @brief simple list structure similar to glib's GList */
40 * @brief return the number of items in the list
41 * @return the number of items in the list
43 int tr_list_size( const tr_list * list );
46 * @brief free the specified list and set its pointer to NULL
47 * @param list pointer to the list to be freed
48 * @param func optional function to invoke on each item in the list
50 void tr_list_free( tr_list ** list, TrListForeachFunc data_free_func );
53 * @brief append an item to the specified list
54 * @param list pointer to the list
57 void tr_list_append( tr_list ** list, void * data );
60 * @brief prepend an item to the specified list
61 * @param list pointer to the list
64 void tr_list_prepend( tr_list ** list, void * data );
67 * @brief remove the next item in the list
68 * @return the next item in the list, or NULL if the list is empty
69 * @param list pointer to the list
71 void* tr_list_pop_front( tr_list ** list );
74 * @brief remove the list's node that contains the specified data pointer
75 * @param list pointer to the list
79 void* tr_list_remove_data( tr_list ** list, const void * data );
82 * @brief remove the list's node that compares equal to "b" when compared with "compare_func"
83 * @param list pointer to the list
85 * @param compare_func the comparison function. The arguments passed to it will be the list's pointers and the comparison key "b"
88 void* tr_list_remove( tr_list ** list,
93 * @brief find the list node whose data that compares equal to "b" when compared with "compare_func"
94 * @param list pointer to the list
96 * @param compare_func the comparison function. The arguments passed to it will be the list's pointers and the comparison key "b"
97 * @return the matching list node, or NULL if not match was found
99 tr_list* tr_list_find( tr_list * list,
104 * @brief Insert in an ordered list
105 * @param list pointer to the list
109 void tr_list_insert_sorted( tr_list ** list,