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