Function ds_filter_init

Function Documentation

struct ds_iterator *ds_filter_init(void *ds, enum ds_tag tag, bool_t (*f)(void *e))

Initialize an iterator for filtering.

Initialize an iterator to iterate over SOME of the elements of a data structure. Implemented for:

Parameters:
  • ds – The data structure to iterate over.

  • tag – What type of data structure to initialize for.

  • f – The function to determine if an element will be returned by the iterator or not. Elements are checked in forward iteration order.

Returns:

The initialized iterator, or NULL if an ERROR occurred