Redis hiredis 客户端库示例代码深度解析-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00898/article/details/148467679

Redis hiredis 客户端库示例代码深度解析

概述

Redis hiredis 是 Redis 官方提供的 C 语言客户端库，本文将通过分析其示例代码 example.c，深入讲解如何使用 hiredis 进行 Redis 数据库操作。这个示例展示了从基础连接到各种命令操作的全过程，是学习 hiredis 的绝佳材料。

连接建立与管理

示例代码首先展示了如何建立与 Redis 服务器的连接：

struct timeval timeout = { 1, 500000 }; // 1.5秒超时
if (isunix) {
    c = redisConnectUnixWithTimeout(hostname, timeout);
} else {
    c = redisConnectWithTimeout(hostname, port, timeout);
}

这里有几个关键点需要注意：

支持 TCP 和 Unix 域套接字两种连接方式
可以设置连接超时时间（1.5秒）
连接后需要检查错误状态

连接建立后，示例代码立即执行了一个 PING 命令来测试连接：

reply = redisCommand(c,"PING");
printf("PING: %s\n", reply->str);
freeReplyObject(reply);

这是 Redis 客户端开发的良好实践，可以立即验证连接是否正常工作。

基本命令操作

示例展示了多种 Redis 命令的使用方式：

SET 命令 - 设置键值对

reply = redisCommand(c,"SET %s %s", "foo", "hello world");

二进制安全 SET 命令 - 处理二进制数据

reply = redisCommand(c,"SET %b %b", "bar", (size_t) 3, "hello", (size_t) 5);

%b 格式说明符配合长度参数，可以安全地处理包含空字符的数据。

GET 命令 - 获取键值

reply = redisCommand(c,"GET foo");

INCR 命令 - 原子递增

reply = redisCommand(c,"INCR counter");

列表操作

示例展示了 Redis 列表的基本操作：

LPUSH 命令 - 向列表头部插入元素

for (j = 0; j < 10; j++) {
    char buf[64];
    snprintf(buf,64,"%u",j);
    reply = redisCommand(c,"LPUSH mylist element-%s", buf);
    freeReplyObject(reply);
}

LRANGE 命令 - 获取列表范围

reply = redisCommand(c,"LRANGE mylist 0 -1");
if (reply->type == REDIS_REPLY_ARRAY) {
    for (j = 0; j < reply->elements; j++) {
        printf("%u) %s\n", j, reply->element[j]->str);
    }
}

这里特别展示了如何处理 Redis 返回的数组类型回复。

高级命令参数处理

示例中 example_argv_command 函数展示了如何使用 redisCommandArgv 接口：

reply = redisCommandArgv(c, n + 2, (const char **)argv, (const size_t*)argvlen);

这种方式的优势在于：

可以精确控制每个参数的长度
避免格式化字符串的开销
更适合程序化生成命令的场景

函数内部构建了一个 RPUSH 命令，动态添加多个元素到列表中，展示了 hiredis 处理可变数量参数的能力。

资源管理与错误处理

示例代码体现了良好的资源管理实践：

每次命令执行后都调用 freeReplyObject 释放回复对象
连接失败时有详细的错误检查和处理
动态分配的内存都有对应的释放操作

if (c == NULL || c->err) {
    if (c) {
        printf("Connection error: %s\n", c->errstr);
        redisFree(c);
    } else {
        printf("Connection error: can't allocate redis context\n");
    }
    exit(1);
}