ping\_iterator\_get(3) liboping ping\_iterator\_get(3)

# [NAME](#NAME)

ping\_iterator\_get, ping\_iterator\_next - Iterate over all hosts of a liboping object

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#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)](/man/os/liboping/ping_iterator_get_info.3) and [**ping\_iterator\_get\_context**(3)](/man/os/liboping/ping_iterator_get_context.3).

# [RETURN VALUE](#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](#SEE_ALSO)

[**ping\_host\_add**(3)](/man/os/liboping/ping_host_add.3), [**ping\_iterator\_get\_info**(3)](/man/os/liboping/ping_iterator_get_info.3), [**ping\_iterator\_get\_context**(3)](/man/os/liboping/ping_iterator_get_context.3), [**liboping**(3)](/man/os/liboping/liboping.3)

# [AUTHOR](#AUTHOR)

liboping is written by Florian "octo" Forster &lt;ff at octo.it&gt;. Its homepage can be found at &lt;http://noping.cc/&gt;.

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

2026-10-10 1.10.0

---

Document: ping_iterator_get(3) from liboping 1.10.0-r7 (Chainguard OS)
Source: https://github.com/octo/liboping.git