Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ping_iterator_get(3)		   liboping		  ping_iterator_get(3)

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 <octo at verplant.org>.
       Its homepage can	be found at <http://verplant.org/liboping/>.

       Copyright (c) 2005-2011 by Florian "octo" Forster.

1.6.2				  2011-09-06		  ping_iterator_get(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ping_iterator_get&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help