地址转换函数

有两组地址转换函数，它们在ASCII字符串与网络字节序的二进制值（这是存放在套接字地址结构中的值）之间转换网际地址。

1、inet_aton、inet_addr和inet_ntoa函数

这三个函数在点分十进制数串（例如“206.168.112.96”）与它长度为32位的网络字节序二进制值间转换IPv4地址。

#include <arpa/inet.h>

int inet_aton(const char *strptr, struct in_addr *addrptr);

返回值：若字符串有效则为1，否则为0

in_addr_t inet_addr(const char *strptr);

返回值：若字符串有效则为32位二进制网络字节序的IPv4地址，否则为INADDR_NONE

char *inet_ntoa(struct in_addr inaddr);

返回值：指向一个点分十进制串的指针

第一个函数inet_aton将strptr所指C字符串转换成一个32位的网络字节序二进制值，并通过指针addrptr来存储。若成功则返回1，否则返回0。如果addrptr指针为空，那么该函数对输入字符串执行有效性检查，但是不存储任何结果。

inet_addr进行相同的转换，返回值为32位的网络字节序二进制值。该函数存在一个问题：所有2^32个可能的二进制值都是有效的IP地址（从0.0.0.0到255.255.255.255），但是当出错时该函数返回INADDR_NONE常值（通常是一个32位均为1的值）。这意味着点分十进制数串255.255.255.255（这是IPv4的有限广播地址）不能由该函数处理。

如今inet_addr已被废弃，新的代码应该改用inet_aton函数。更好的方法是使用下一节中介绍的新函数，它们对于IPv4地址IPv6地址都适用。

inet_ntoa函数将一个32位的网络字节序二进制IPv4地址转成相应的点分十进制数串。由该函数的返回值所指向的字符串驻留在静态内存中。这意味着该函数是不可重入的。最后需要留意，该函数以一个结构而不是以指向该结构的一个指针作为其参数。

2、inet_pton和inet_ntop函数

这两个函数是随IPv6出现的新函数，对于IPv4地址和IPv6地址都适用。函数名中的p和n分别代表表达（presentation）和数值（numeric）。地址的表达格式通常是ASCII字符串，数值格式则是存放到套接字地址结构中的二进制值。

#include <arpa/inet.h>

int inet_pton(int family, const char *strptr, void *addrptr);

返回值：若成功则为1，若输入不是有效的表达格式则为0，若出错则为-1

const char *inet_ntop(int family, const void *addrptr, char *strptr, size_t len);

返回值：若成功则为指向结果的指针，若出错则为NULL

这两个函数的family参数即可以是AF_INET，也可以是AF_INET6。如果以不支持的地址族作为family参数，这两个函数就都返回一个错误，并将errno置为EAFNOSUPPORT。

第一个函数尝试转换由strptr指针所指的字符串，并通过addrptr指针存放二进制结果。若成功则返回值为1，否则如果对所指定的family而言输入的字符串不是有效的表达格式，那么返回值为0。

inet_ntop进行相反的转换，从数值格式（addrptr）转换到表达格式（strptr）。len参数是目标存储单元的大小，以免该函数溢出其调用者的缓冲区。为有助于指定这个大小，在<netinet/in.h>头文件中有如下定义：

#define INET_ADDRSTRLEN 16 /* for IPv4 dotted-decimal */

#define INET6_ADDRSTRLEN 46 /* for IPv6 hex string */

如果len太小，不足以容纳表达格式结果（包括结束符），那么返回一个空指针，并置errno为ENOSPC。

inet_ntop函数的strptr参数不可以是一个空指针。调用者必须为目标存储单元分配内存并指定其大小。调用成功时，这个指针就是该函数的返回值。

示例：

　　struct sockaddr_in foo;　　char *cp = “192.168.0.1”;　　char str[INET_ADDRSTRLEN];　　　　inet_pton(AF_INET, cp, &foo.sin_addr);　　inet_ntop(AF_INET, &foo.sin_addr, str, sizeof(str));

图1给出了只支持IPv4的inet_pton函数的简单定义。类似地，图2给出了只支持IPv4的inet_ntop函数的简化版本。

　　int inet_pton(int family, const char *strptr, void *addrptr)　　  {　　      if (family == AF_INET) {　　          struct in_addr addr;　　          if (inet_aton(strptr, &addr) == 1) {　　              memcpy(addrptr, &addr, sizeof(addr));　　              return 1;　　          }　　          return 0;　　      }　　      errno = EAFNOSUPPORT;　　      return -1;　　  }

图1 仅支持IPv4的inet_pton简化版本

　　char* inet_ntop(int family, const void *addrptr, char *strptr, size_t len)　　 {　　      const u_char *p = addrptr;　　  　　      if (family == AF_INET) {　　          char temp[INET_ADDRSTRLEN];　　          snprintf(temp, INET_ADDRSTRLEN, "%d.%d.%d.%d", p[0], p[1], p[2], p[3]);　　          if (strlen(temp) >= len) {　　              errno = ENOSPC;　　              return NULL;　　          }　　          strcpy(strptr, temp);　　          return strptr;　　      }　　      errno = EAFNOSUPPORT;　　      return NULL;　　  }

图2 仅支持IPv4的inet_ntop简化版本