int socket_set_nonblocking(evutil_socket_t fd) { #if defined(WINDOWS) unsigned long nonblocking = 1; ioctlsocket(fd, FIONBIO, (unsigned long *)&nonblocking); #else if (fcntl(fd, F_SETFL, O_NONBLOCK) == -1) { perror("O

以下是对 socket_set_nonblocking 函数的详细注释，帮助理解其功能和参数：

/**
 * @brief 将指定的套接字设置为非阻塞模式。
 *
 * 此函数用于将给定的套接字描述符（fd）设置为非阻塞状态，
 * 这样在读取或写入操作时，如果没有数据可用（对于读取）或不能立即发送数据（对于写入），
 * 函数不会阻塞进程，而是立即返回。
 *
 * @param fd 待设置为非阻塞的套接字描述符，必须是有效的非负整数。
 *
 * @return 成功时返回 0；失败时返回 -1，并通过 perror 打印错误信息。
 */
int socket_set_nonblocking(evutil_socket_t fd) {
#if defined(WINDOWS)
    unsigned long nonblocking = 1; // 设置标志位以启用非阻塞模式
    // 在 Windows 平台上使用 ioctlsocket 函数来设置套接字为非阻塞
    ioctlsocket(fd, FIONBIO, (unsigned long *)&nonblocking);
#else
    // 在类 Unix 系统上使用 fcntl 函数来设置套接字为非阻塞
    if (fcntl(fd, F_SETFL, O_NONBLOCK) == -1) {
        perror("O_NONBLOCK"); // 如果发生错误，打印错误信息
        return -1; // 返回错误代码
    }
#endif
    return 0; // 成功返回
}

总结说明：

功能: 将指定的套接字设置为非阻塞模式，这样可以避免在进行网络读写操作时造成程序挂起。
平台差异:
- 对于 Windows 平台，使用 ioctlsocket 和 FIONBIO 控制命令来实现；
- 对于类 Unix 系统，则使用 fcntl 系统调用和 O_NONBLOCK 标志来实现。
错误处理: 若设置失败，将会打印相应的错误信息并返回 -1。

内容由零声教学AI助手提供，问题来源于学员提问