ping_iterator_get3
Iterate over all hosts of a liboping object
Usage
#include <oping.h>pingobj_iter_t *ping_iterator_get (pingobj_t *obj);pingobj_iter_t *ping_iterator_next (pingobj_iter_t *iter)
Overview
These two functions can be used to iterate over all hosts associated with a liboping object. You can use these methods as follows:
pingobj_iter_t *iter;for (iter = ping_iterator_get (obj);iter != NULL;iter = ping_iterator_next (iter)){...;}
To get usable information from an iterator object (which is also an opaque data type, just like the liboping object itself) use ping_iterator_get_info(3) and ping_iterator_get_context(3).
Return value
The ping_iterator_get returns an iterator for obj or NULL if no host is associated with obj.
The ping_iterator_next returns an iterator for the host following iter or NULL if the last host has been reached.
Releases
10 releases since Debian 4.0 (Etch); the text changed 9 times.