inet_ntop(), inet_pton()

Beej's Guide to Network Programming 正體中文版
Search…
將 IP addresses 轉換為可讀的格式，及轉換回來。
函式原型
1
#include <arpa/inet.h>
2
​
3
const char *inet_ntop(int af, const void *src, char *dst, socklen_t size);
4
​
5
int inet_pton(int af, const char *src, void *dst);
Copied!
說明
這些函式用於處理將可讀的 IP addresses 轉換為許多函式與 system calls 使用的二進位格式，"n" 表示 "network"，而 "p" 表示 "presentation" 或 "text presentation"。可是你可以想成它是＂可印的＂，而 "ntop" 表示 "network to printable"，這樣知道了嗎？
有時你不想要看一堆二進制數字格式的 IP address，你想要比較好懂的格式，類似 192.0.2.180 或 2001:db8:8714:3a90::12 這樣的格式。在這種情況下，你可以使用 inet_ntop()。
inet_ntop() 在 af 參數中代入 address family（不是 AF_INET 就是 AF_INET6），src 參數應該是個指向 struct in_addr 或 struct in6_addr 的指標，會包含你想要轉換為字串的 address。最後，dst 與 size 是指向目地字串與該字串最大長度的指標。
dst 字串的最大長度是多少呢？ IPv4 與 IPv6 address 的最大長度是多少呢？很幸運地，有兩個 macros（巨集）可以幫你做這件事，最大長度是：INET_ADDRSTRLEN 與 INET6_ADDRSTRLEN。
有時你可能會需要將字串格式的 IP address 封裝到 struct sockaddr_in 或 struct sockaddr_in6，此時，相對的 inet_pton() 就是你需要的函式。
inet_pton() 也會在 af 參數代入一個 address family（不是 AF_INET 就是 AF_INET6）、src 參數是指向可列印格式的 IP address 字串、最後的 dst 參數指向要儲存結果的地方，這可能是 struct in_addr 或 struct in6_addr。
上述的這些函式不能做 DNS 查詢，你需要使用 getaddinfo()。
傳回值
inet_ntop() 成功時傳回 dst 參數，失敗時傳回 NULL（並設定 errno）。
inet_pton() 成功時傳回 1，有錯誤時傳回 -1（設定 errno）；若輸入的 IP address 不正確，則傳回 0。
範例
1
// inet_ntop() 與 inet_pton() 的 IPv4 demo
2
​
3
struct sockaddr_in sa;
4
char str[INET_ADDRSTRLEN];
5
​
6
// 將這個 IP address 儲存在 sa：
7
inet_pton(AF_INET, "192.0.2.33", &(sa.sin_addr));
8
​
9
// 現在取回並印出來
10
inet_ntop(AF_INET, &(sa.sin_addr), str, INET_ADDRSTRLEN);
11
​
12
printf("%s\n", str); // 印出 "192.0.2.33"
13
// inet_ntop() 與 inet_pton() 的 IPv6 Demo
14
// （基本上一樣，除了多個 6）
15
​
16
struct sockaddr_in6 sa;
17
char str[INET6_ADDRSTRLEN];
18
​
19
// 將 IP address 儲存在 sa：
20
inet_pton(AF_INET6, "2001:db8:8714:3a90::12", &(sa.sin6_addr));
21
​
22
// 現在取回並印出來
23
inet_ntop(AF_INET6, &(sa.sin6_addr), str, INET6_ADDRSTRLEN);
24
​
25
printf("%s\n", str); // 印出 "2001:db8:8714:3a90::12"
26
// 你會用到的實用函式：
27
​
28
//將 sockaddr address 轉換為字串，包含 IPv4 與 IPv6：
29
​
30
char *get_ip_str(const struct sockaddr *sa, char *s, size_t maxlen)
31
{
32
    switch(sa->sa_family) {
33
        case AF_INET:
34
            inet_ntop(AF_INET, &(((struct sockaddr_in *)sa)->sin_addr),
35
                    s, maxlen);
36
            break;
37
​
38
        case AF_INET6:
39
            inet_ntop(AF_INET6, &(((struct sockaddr_in6 *)sa)->sin6_addr),
40
                    s, maxlen);
41
            break;
42
​
43
        default:
44
            strncpy(s, "Unknown AF", maxlen);
45
            return NULL;
46
    }
47
​
48
    return s;
49
}
Copied!
參考
getaddrinfo()
inet_ntoa(), inet_aton(), inet_addr
listen()
Last modified 1yr ago
Copy link
Contents