"Fossies" - the Fresh Open Source Software Archive

Member "liboping-1.10.0/src/mans/ping_iterator_get.3" (11 May 2017, 5516 Bytes) of package /linux/privat/liboping-1.10.0.tar.gz:


Caution: As a special service "Fossies" has tried to format the requested manual source page into HTML format but links to other man pages may be missing or even erroneous. Alternatively you can here view or download the uninterpreted manual source code. A member file download can also be achieved by clicking within a package contents listing on the according byte size field. See also the latest Fossies "Diffs" side-by-side code changes report for "ping_iterator_get.3": 1.9.0_vs_1.10.0.

ping_iterator_get

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
SEE ALSO
AUTHOR

NAME

ping_iterator_get, ping_iterator_next − Iterate over all hosts of a liboping object

SYNOPSIS

#include <oping.h>
pingobj_iter_t *ping_iterator_get (pingobj_t *obj);
pingobj_iter_t *ping_iterator_next (pingobj_iter_t *iter)

DESCRIPTION

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.

SEE ALSO

ping_host_add(3), ping_iterator_get_info(3), ping_iterator_get_context(3), liboping(3)

AUTHOR

liboping is written by Florian "octo" Forster <ff at octo.it>. Its homepage can be found at <http://noping.cc/>.

Copyright (c) 2006−2017 by Florian "octo" Forster.