r6.0.0:lfds600_slist_get_head_and_then_next
Source Files
/liblfds600/src/lfds600_slist/lfds600_slist_get_and_set.c /liblfds600/inc/liblfds600.h
Prototype
struct lfds600_slist_element *lfds600_slist_get_head_and_next( struct lfds600_slist_state *ss, struct lfds600_slist_element **se );
Parameters
struct lfds600_slist_state *ss
- An slist state as allocated by lfds600_slist_new.
struct lfds600_slist_element **se
- A pointer to a pointer which will be set to point to an slist element. When this function is first called, *se must be NULL (e.g. the value of the pointer pointed to by this argument must be NULL).
Return Value
When *se is NULL, *se is set to point to the head element and the new value of *se is returned.
When *se is not NULL, *se is set to point to the element immediately after *se and the new value of *se is returned. This value will be NULL if there was no element after the original value of *se.
Notes
This function is for use in loops. When we first come into the loop, we have set *se to NULL, so the function sets *se to the head element. When we loop, because *se is not NULL, the function there-after sets *se to the next element in the list.
Without this function, the lfds600_slist_get_head function must be used before the loop, with the lfds600_slist_get_next function being then used inside the loop, like so;
struct lfds600_slist_element
*se;
lfds600_slist_get_head( ss, &se );
while( se != NULL )
{
...
lfds600_slist_get_next( se, &se );
}
With it, the loop is rewritten thus;
strut lfds600_slist_element
*se = NULL;
while( lfds600_slist_get_head_and_then_next(ss, &se) )
{
...
}