hiredis从安装到实操，带 API 详解

Posted 2022-01-20 看，未来

文章目录

• • 花个两分钟跟我一起配置hiredis
  • redis的C/C++ API
  • • 建立连接
    • 写数据库
    • 读数据库
    • 释放内存
    • 释放连接
  • 实操代码示例

花个两分钟跟我一起配置hiredis

当我们下载了最新版redis的时候，其实就已经自带了C++版本的操作库，只不过有些人没发现罢了。

进入到deps->hiredis目录下（在你的redis解压目录下有deps）

然后：make install

一步到位。

其实连测试函数他们都给你准备好了，在hedis文件夹中还有个文件夹，example，里面有个example.c文件。

这样编译，如果不会的话：首先需要把里面的头文件改一下：#include<hiredis/hiredis.h>
编译的时候记得带上依赖项：
gcc example.c -o example -L/usr/local/lib -lhiredis

当你运行的时候，（别给我说你不会运行：./example）如果不出意外，会跟你说依赖项找不着。
正常，教你一个治标的办法：

在/etc/ld.so.conf.d/目录下新建文件usr-libs.conf，内容是：/usr/local/lib

然后使用命令/sbin/ldconfig更新一下配置即可。

这东西配置完，你虚拟机重启之后就没了，永久配置好像在我的另一篇博客里有，动态库专栏下。

最后的运行效果：

redis的C/C++ API

建立连接

redisContext* pRedisContext=(redisContext*)redisConnect(ip, port);//建立连接

参数释义：
该函数用来连接redis数据库， 两个参数分别是redis数据库的ip和端口，端口号一般为6379。

如果是密码连接，在连接后还要输入密码登录：

reply = (redisReply *)redisCommand(pRedisContext, "AUTH %s", redis_password);//密码访问

---

写数据库

std::string key, value;
...
redisReply *reply;
reply = (redisReply *)redisCommand(redisContext,"SET %s %s", key.c_str(), value.c_str());//写

这里要注意，对于序列化的结构数据，string中保存的是二进制数据，c_str()方法返回的c字符串被二进制0值截断，会造成数据不完整，而hiredis提供%b作为格式化二进制的方法，需要提供起始地址和长度：

reply = (redisReply *)redisCommand(redisContext, "SET %s %b", key.c_str(), value.data(), value.length());
//写长byte流

---

读数据库

redisReply *reply;
reply = (redisReply *)redisCommand(redisContext,"GET %s", key.c_str());//读
std::cout<<reply->str;

---

释放内存

void freeReplyObject(void *reply);

释放redisCommand执行后返回的的redisReply所占用的内存。

---

释放连接

void redisFree(redisContext *c)

释放redisConnect()所产生的连接。

---

实操代码示例

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include<hiredis/hiredis.h>

int main(int argc, char **argv) 
    unsigned int j, isunix = 0;
    redisContext *c;		
    redisReply *reply;		：
    const char *hostname = (argc > 1) ? argv[1] : "127.0.0.1";

    if (argc > 2) 
        if (*argv[2] == 'u' || *argv[2] == 'U') 
            isunix = 1;
            /* in this case, host is the path to the unix socket */
            printf("Will connect to unix socket @%s\\n", hostname);
        
    

    int port = (argc > 2) ? atoi(argv[2]) : 6379;
    
	struct timeval timeout =  1, 500000 ; // 1.5 seconds
    if (isunix) 
        c = redisConnectUnixWithTimeout(hostname, timeout);
        //该函数用来连接redis数据库， 两个参数分别是redis数据库的ip和端口，端口号一般为6379。
     else 
        c = redisConnectWithTimeout(hostname, port, timeout);
    
    if (c == NULL || c->err) 
        if (c) 
            printf("Connection error: %s\\n", c->errstr);	
            redisFree(c);	//释放redisConnect()所产生的连接。
         else 
            printf("Connection error: can't allocate redis context\\n");
        
        exit(1);
    

	 /* PING server */
    reply = redisCommand(c,"PING");	
    //该函数用于执行redis数据库中的命令，第一个参数为连接数据库返回的redisContext，剩下的参数为变参.。
	//此函数的返回值为void*，但是一般会强制转换为redisReply类型，以便做进一步的处理。
    
    printf("PING: %s\\n", reply->str);
    freeReplyObject(reply);	//释放redisCommand执行后返回的的redisReply所占用的内存。

	 /* Set a key */
    reply = redisCommand(c,"SET %s %s", "foo", "hello world");
    printf("SET: %s\\n", reply->str);
    freeReplyObject(reply);

    /* Set a key using binary safe API */
    reply = redisCommand(c,"SET %b %b", "bar", (size_t) 3, "hello", (size_t) 5);
    printf("SET (binary API): %s\\n", reply->str);
    freeReplyObject(reply);

    /* Try a GET and two INCR */
    reply = redisCommand(c,"GET foo");
    printf("GET foo: %s\\n", reply->str);
    freeReplyObject(reply);

    reply = redisCommand(c,"INCR counter");
    printf("INCR counter: %lld\\n", reply->integer);
    freeReplyObject(reply);
    /* again ... */
    reply = redisCommand(c,"INCR counter");
    printf("INCR counter: %lld\\n", reply->integer);
    freeReplyObject(reply);

    /* Create a list of numbers, from 0 to 9 */
    reply = redisCommand(c,"DEL mylist");
    freeReplyObject(reply);
    for (j = 0; j < 10; j++) 
        char buf[64];
        snprintf(buf,64,"%u",j);
        reply = redisCommand(c,"LPUSH mylist element-%s", buf);
        freeReplyObject(reply);
    

    /* Let's check what we have inside the list */
    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);
        
    
    freeReplyObject(reply);

    /* Disconnects and frees the context */
    redisFree(c);

    return 0;