IP地址转换函数——inet_pton inet_ntop inet_aton inet_addr inet_ntoa

inet_pton

NAME
    inet_pton - 将 IPv4 和 IPv6 地址从点分十进制转换为二进制

SYNOPSIS

	#include <arpa/inet.h>
	int inet_pton(int af, const char *src, void *dst);

DESCRIPTION
    该函数将字符串src转换为af地址类型协议簇的网络地址，并存储到dst中。对于af参数，必须为AF_INET或AF_INET6

RETURN VALUE
    inet_pton转换成功则返回1,对于指定的地址类型协议簇，如果不是一个有效的网络地址，将转换失败，返回 0,如果指定的地址类型协议簇不合法，将返回-1并，并且errno设置为EAFNOSUPPORT

NOTES
    不同于inet_aton和inet——addr，inept_pton支持 IPv6 地址。另一方面，inet_pton仅支持点分十进制表示的 IPv4 地址，而inet_aton和inet_addr接受更通用的数字和点表示法（十六进制和八进制数字格式，以及格式不需要显式写入所有四个字节）。

inet_ntop

NAME
    inet_ntop - 将 IPv4 和 IPv6 地址从二进制转换为点分十进制

SYNOPSIS

	#include <arpa/inet.h>
	const char *inet_ntop(int af, const void *src, char *dst, socklen_t size);

DESCRIPTION
    该函数将地址类型协议簇为af的网络地址src转换为字符串，并将其存储到dst中，其中dst不能是空指针。调用者在参数size中指定可使用的缓冲字节数。
    inet_ntop拓展自inet_ntoa来支持多种地址类型协议簇，inet_ntoa现在已经被弃用。

RETURN VALUE
    inet_ntop执行成功，返回一个指向dst的非空指针，如果执行失败，将返回NULL，并且errno设置为相应的错误类型。

ERRORS

• EAFNOSUPPORT
  af并不是一个合法的地址类型协议簇
• ENOSPC
  要转换的字符串地址src其字节大小超过了给定的缓冲字节大小

EXAMPLE

    以下是关于inet_pton和inet_ntop函数使用的例子

#include <arpa/inet.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

int main(int argc, char *argv[])
{
   unsigned char buf[sizeof(struct in6_addr)];
   int domain, s;
   char str[INET6_ADDRSTRLEN];

   if (argc != 3) {
       fprintf(stderr, "Usage: %s {i4|i6|<num>} string\n", argv[0]);
       exit(EXIT_FAILURE);
   }

   domain = (strcmp(argv[1], "i4") == 0) ? AF_INET :
            (strcmp(argv[1], "i6") == 0) ? AF_INET6 : atoi(argv[1]);

   s = inet_pton(domain, argv[2], buf);
   if (s <= 0) {
       if (s == 0)
           fprintf(stderr, "Not in presentation format");
       else
           perror("inet_pton");
       exit(EXIT_FAILURE);
   }

   if (inet_ntop(domain, buf, str, INET6_ADDRSTRLEN) == NULL) {
       perror("inet_ntop");
       exit(EXIT_FAILURE);
   }

   printf("%s\n", str);

   exit(EXIT_SUCCESS);
}

inet_aton inet_addr inet_ntoa

NAME
    inet_aton, inet_addr, inet_ntoa - 网络地址操作例程

SYNOPSIS

	#include <sys/socket.h>
	#include <netinet/in.h>
	#include <arpa/inet.h>
	
	typedef uint32_t in_addr_t;
	struct in_addr{
		in_addr_t s_addr;
	};

	int inet_aton(const char *cp, struct in_addr *inp);
	in_addr_t inet_addr(const char *cp);
	char *inet_ntoa(struct in_addr in);

DESCRIPTION
    inet_aton函数将网络主机地址cp从 IPv4 的点分十格式转换为二进制值（以网络字节序）并且把它保存在inp指针指向的结构体中。如果地址是合法的，那么inet_aton函数返回非0值，反之返回0值。cp中提供的地址可以要有以下几种格式：

• a.b.c.d 四个数字部分中的每一个指定地址的一个字节，字节按从左到右的顺序分配以产生二进制地址。
• a.b.c a和b指定二进制地址的前两个字节,c被解释为16位值,它定义二进制地址的最右边两个字节。此表示法适用于指定（过时的）B类网络地址。
• a.b a指定二进制地址的第一个字节,b被解释为24位值,它定义了二进制地址的最右边三个字节。此表示法适用于指定（过时的）A类网络地址。
• a a被解释为32位值,直接存储到二进制地址中而不进行任何字节重新排列。
      在所有上述形式中，虚线标示的地址格式可以用十进制，八进制（带前导0）或十六进制指定（前导0X）。任何这些形式的地址统称为IPV4数字和点符号。使用正好四个十进制数称为 IPv4 点分十进制表示法。
      如果提供的字符串地址被成功转换，inet_aton函数返回1,如果提供的字符串地址不合法，返回0（此时errno不会被设置为错误）

    inet_addr函数将网络主机地址cp从 IPv4 的数字点表示形式转换为以网络字节顺序的二进制形式。如果输入不合法，INADDR_NONE（通常为-1）被返回。这个函数存在一个问题，因为-1是一个合法的地址（255.255.255.255）。可以使用inet_aton函数、inet_pton函数或者getaddrinfo函数来代替使用它，这些函数提供了一种更清晰的方式来指示错误返回。

    inet_ntoa函数将网络主机地址in转换为点分十格式的 IPv4 地址。该函数的返回值所指向的字符串驻留在静态内存中，后续调用将覆盖该缓冲区。

NOTES
    在 x86 架构中，主机字节顺序首先是最低有效字节（小端），而在因特网上使用的网络字节顺序是最高有效字节（大端）。

EXAMPLE

#include <arpa/inet.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

int main(int argc, char *argv[])
{
   unsigned char buf[sizeof(struct in6_addr)];
   int domain, s;
   char str[INET6_ADDRSTRLEN];

   if (argc != 3) {
       fprintf(stderr, "Usage: %s {i4|i6|<num>} string\n", argv[0]);
       exit(EXIT_FAILURE);
   }

   domain = (strcmp(argv[1], "i4") == 0) ? AF_INET :
            (strcmp(argv[1], "i6") == 0) ? AF_INET6 : atoi(argv[1]);

   s = inet_pton(domain, argv[2], buf);
   if (s <= 0) {
       if (s == 0)
           fprintf(stderr, "Not in presentation format");
       else
           perror("inet_pton");
       exit(EXIT_FAILURE);
   }

   if (inet_ntop(domain, buf, str, INET6_ADDRSTRLEN) == NULL) {
       perror("inet_ntop");
       exit(EXIT_FAILURE);
   }

   printf("%s\n", str);

   exit(EXIT_SUCCESS);
}