List Interface SilcList SILC_LIST_END silc_list_init silc_list_init_prev silc_list_count silc_list_start silc_list_end silc_list_add silc_list_insert silc_list_del silc_list_get silc_list_pop silc_list_sort silc_list_find

silc_list_find

SYNOPSIS

    void *silc_list_find(SilcList list, void *entry1, SilcCompare compare,
                         void *context);

DESCRIPTION

Find an entry from the `list'. The `compare' function will be called with `context' to do comparison between the entries. If `compare' returns 0 the `entry1' is considered to be equal to `entry2' and the found entry is returned. Returns NULL if the entry could not be found.

The silc_list_start or silc_list_end must be called before calling this if the finding should be started from the beginning or from the end. Calling it however is not required. The founding can be started at any point of the list. The silc_list_find can be called many times to find more entries following the previously found entries.

The list can be enumerated by calling silc_list_get after the found entry. The silc_list_get will return the next entry after the found entry.