---
name: "ping_construct"
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_construct"
---

# ping\_construct(3)

Constructor for the liboping class

## NAME

ping\_construct - Constructor for the liboping class

## SYNOPSIS

```
  #include <oping.h>
  pingobj_t *ping_construct (void);
  void       ping_destroy   (pingobj_t *obj);
```

## DESCRIPTION

The **ping\_construct** constructor allocates the memory necessary for a liboping object, initializes that memory and returns a pointer to it.

The **ping\_destroy** iterates over all hosts associated with the liboping object *obj*, closes the sockets, removes the hosts and frees *obj*'s memory.

## RETURN VALUE

The **ping\_construct** constructor returns a pointer to the allocated memory or NULL if no memory could be allocated.

## SEE ALSO

[**ping\_setopt**(3)](/ping_setopt/3.md), [**ping\_send**(3)](/ping_send/3.md), [**ping\_host\_add**(3)](/ping_host_add/3.md), [**ping\_get\_error**(3)](/ping_get_error/3.md), [**ping\_iterator\_get**(3)](/ping_iterator_get/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.