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);
}