ARES\_INET\_PTON(3) Library Functions Manual ARES\_INET\_PTON(3)

# [NAME](#NAME)

ares\_inet\_pton - convert an IPv4 or IPv6 address from text to binary form

# [SYNOPSIS](#SYNOPSIS)

```
#include <ares.h>
int ares_inet_pton(int af, const char *src, void *dst);
```

# [DESCRIPTION](#DESCRIPTION)

This is a portable version with the identical functionality of the commonly available *inet\_pton*.

The ares\_inet\_pton() function converts the address in its standard text presentation form into its numeric binary form. The **af** argument shall specify the family of the address. The AF\_INET and AF\_INET6 address families shall be supported. The **src** argument points to the string being passed in. The **dst** argument points to a buffer into which the function stores the numeric address; this shall be large enough to hold the numeric address (32 bits for AF\_INET, 128 bits for AF\_INET6).

It returns 1 if the address was valid for the specified address family, or 0 if the address was not parseable in the specified address family, or -1 if some system error occurred (in which case errno will have been set).

# [SEE ALSO](#SEE_ALSO)

[**ares\_init**(3)](/man/os/c-ares/ares_init.3), [**ares\_inet\_ntop**(3)](/man/os/c-ares/ares_inet_ntop.3)

# [AVAILABILITY](#AVAILABILITY)

made properly publicly available in c-ares for real in version 1.10.0

17 Feb 2013

---

Document: ares_inet_pton(3) from c-ares 1.34.8-r2 (Chainguard OS)
Source: https://github.com/c-ares/c-ares