getaddrinfo
是一个在 C 语言中用于解析主机名(hostname)和服务名(service name)的函数。它提供了一种更灵活且可扩展的方法来获取与特定地址族、套接字类型和协议相关的网络地址信息。
函数原型
#include <sys/types.h>
#include <sys/socket.h>
#include <netdb.h>
int getaddrinfo(const char *node, const char *service,
const struct addrinfo *hints,
struct addrinfo **res);
参数说明
node
:要解析的主机名或 IP 地址。如果为 NULL,表示将使用指定的service
。service
:要解析的服务名(例如,“http”)或者是服务的端口号(以字符串形式)。hints
:指向一个struct addrinfo
结构体的指针,用于指定调用中的偏好设置(如地址族、套接字类型等)。res
:输出参数,指向填充了返回结果链表的指针。在使用完毕后,应该用freeaddrinfo()
来释放这个链表。
返回值
- 成功时返回 0。
- 出错时返回一个错误码,可以通过
<netdb.h>
中定义的错误码进行判断。
示例代码
下面是一个简单的例子,演示如何使用 getaddrinfo
函数:
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/types.h>
#include <sys/socket.h>
#include <netdb.h>
int main() {
struct addrinfo hints, *res;
int status;
memset(&hints, 0, sizeof hints);
hints.ai_family = AF_INET; // IPv4
hints.ai_socktype = SOCK_STREAM; // TCP
const char *hostname = "www.example.com";
const char *port = "80"; // HTTP port
if ((status = getaddrinfo(hostname, port, &hints, &res)) != 0) {
fprintf(stderr, "getaddrinfo error: %s\n", gai_strerror(status));
return 1;
}
// 使用 res 链表中的信息创建 socket 或者连接等操作
for (struct addrinfo *p = res; p != NULL; p = p->ai_next) {
void *addr;
char *ipver;
// 获取指向对应地址族的指针
if (p->ai_family == AF_INET) { // IPv4
struct sockaddr_in *ipv4 = (struct sockaddr_in *)p->ai_addr;
addr = &(ipv4->sin_addr);
ipver = "IPv4";
} else { // IPv6
struct sockaddr_in6 *ipv6 = (struct sockaddr_in6 *)p->ai_addr;
addr = &(ipv6->sin6_addr);
ipver = "IPv6";
}
// 转换为可读格式并打印出来
char ipstr[INET6_ADDRSTRLEN];
inet_ntop(p->ai_family, addr, ipstr, sizeof ipstr);
printf("%s: %s\n", ipver, ipstr);
}
freeaddrinfo(res); // 释放链表内存
return 0;
}
在这个例子中,我们解析了主机名 "www.example.com"
的 IP 地址,并打印出其 IPv4 和 IPv6 地址。请注意,要正确处理链表并释放其占用的内存,以避免内存泄漏。
内容由零声教学AI助手提供,问题来源于学员提问