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_get

SYNOPSIS

    void *silc_list_get(SilcList list);

DESCRIPTION

Returns the current entry from the list indicated by `list' and moves the list pointer forward so that calling this next time will return the next entry from the list. This can be used to traverse the list. Returns SILC_LIST_END when the entire list has been tarversed and no additional entries exist in the list. Later, silc_list_start (or silc_list_end) must be called again when re-starting the list tarversing.

EXAMPLE

    // Traverse the list from the beginning to the end
    silc_list_start(list);
    while ((entry = silc_list_get(list)) != SILC_LIST_END) {
      ...
    }

    // Traverse the list from the end to the beginning
    silc_list_end(list);
    while ((entry = silc_list_get(list)) != SILC_LIST_END) {
      ...
    }