3 ping_iterator_get, ping_iterator_next - Iterate over all hosts of a liboping object
9 pingobj_iter_t *ping_iterator_get (pingobj_t *obj);
10 pingobj_iter_t *ping_iterator_next (pingobj_iter_t *iter)
14 These two functions can be used to iterate over all hosts associated with a
15 liboping object. You can use these methods as follows:
19 for (iter = ping_iterator_get (obj);
21 iter = ping_iterator_next (iter))
26 To get usable information from an iterator object (which is also an opaque data
27 type, just like the liboping object itself) use L<ping_iterator_get_info(3)> and
28 L<ping_iterator_get_context(3)>.
32 The B<ping_iterator_get> returns an iterator for I<obj> or NULL if no host is
33 associated with I<obj>.
35 The B<ping_iterator_next> returns an iterator for the host following I<iter> or
36 NULL if the last host has been reached.
41 L<ping_iterator_get_info(3)>,
42 L<ping_iterator_get_context(3)>,
47 liboping is written by Florian "octo" Forster E<lt>octo at verplant.orgE<gt>.
48 Its homepage can be found at L<http://verplant.org/liboping/>.
50 Copyright (c) 2005-2011 by Florian "octo" Forster.