---
name: "ping_iterator_get"
section: "3"
platform: "linux"
package: "liboping-dev"
version: "1.10.0-5+b5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ping_iterator_get"
---

# ping\_iterator\_get(3)

Iterate over all hosts of a liboping object

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

## 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_host_add/3.md), [**ping\_iterator\_get\_info**(3)](/ping_iterator_get_info/3.md), [**ping\_iterator\_get\_context**(3)](/ping_iterator_get_context/3.md), [**liboping**(3)](/liboping/3.md)

## 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.