Redis C语言客户端库hiredis文档翻译

最新推荐文章于 2023-04-21 11:08:35 发布
最新推荐文章于 2023-04-21 11:08:35 发布
阅读量154 收藏
点赞数
分类专栏： Redis 文章标签： redis

Hiredis是redis数据库一个轻量的C语言客户端库。

之所以轻量是由于它只是简单的提供了对redis操作语句支持的接口，并没有实现具体的操作语句的功能。但正是由于这种设计使我们只要熟悉了通用的redis操作语句就可以很容易的使用该库和redis数据库进行交互。

除了支持发送命令和接收应答/应答数据，它提供了对应答数据的解析操作。而且这个基于I/O层的数据流解析操作设计考虑到了复用性，可以对应答数据进行通用的解析操作。

Hirides仅仅支持二进制安全的redis协议，所以你只能针对版本号大于等于1.2.0的redis服务端使用。

库包含多种API，包括同步命令操作API、异步命令操作API和对应答数据进行解析的API。

升级

版本0.9.0是hiredis很多特性一次大的更新。但是对现有代码进行升级应该不会造成大的问题。升级时，要记住的关键一点是大于等于0.9.0的版本是使用redisContext*来保持连接状态，之前的版本只是使用了无状态的文件描述符。

同步API

有几个API需要介绍

redisContext *redisConnect(const char *ip, int port);
void *redisCommand(redisContext *c, const char *format, ...);
void freeReplyObject(void *reply);

连接redis数据库

函数 redisConnect 被用来创建一个 redisContext。这个 context 是hiredis持有的连接状态。redisConnect 结构体有一个整型的 err 变量来标识连接错误码，如果连接错误则为非零值。变量 errstr 标识连接结果的文字描述。更多这方面的信息会在以下Errors章节说明。当你使用 redisConnect 来创建连接时应该检查err变量来判断是否连接正常建立。

redisContext *c = redisConnect("127.0.0.1", 6379);
if (c != NULL && c->err) {
printf("Error: %s\n", c->errstr); // handle error }

发送命令到redis

有多种方法可以发送命令到redis。

首先介绍的是redisCommand。此函数类似于printf的使用方式，如

reply = redisCommand(context, "SET foo bar");

类似于printf的s%格式化方式，如

reply = redisCommand(context, "SET foo %s", value);

当你需要发送二进制安全的命令可以采用%b的格式化方式，同时需要一个字符串指针和size_t类型的字符串长度参数,如下

reply = redisCommand(context, "SET foo %b", value, (size_t) valuelen);

在API内部，Hiredis根据不同的参数分割命令转化为操作redis数据库的标准命令，你可以格式化多个参数来构造redis的命令，如下

reply = redisCommand(context, "SET key:%s %s", myid, value);

处理redis应答

当命令被成功执行后redisCommand会有相应的返回值。如果有错误发生，返回值为NULL并且redisReply结构体中的err变量将会被设置成相应的值（请参照Errors章节）。一旦有错误发生context不能被重用并且你需要建立一个新的连接。

redisCommand执行后返回值类型为redisReply。通过redisReply结构体中的type变量可以确定命令执行的情况。

  • REDIS_REPLY_STATUS：

    • 返回执行结果为状态的命令。比如set命令的返回值的类型是REDIS_REPLY_STATUS，然后只有当返回信息是"OK"时，才表示该命令执行成功。可以通过reply->str得到文字信息，通过reply->len得到信息长度。

  • REDIS_REPLY_ERROR：

    • 返回错误。错误信息可以通过reply->str得到文字信息，通过reply->len得到信息长度。

  • REDIS_REPLY_INTEGER：

    • 返回整型标识。可以通过reply->integer变量得到类型为long long的值。

  • REDIS_REPLY_NIL:

    • 返回nil对象，说明不存在要访问的数据。

  • REDIS_REPLY_STRING:

    • 返回字符串标识。可以通过reply->str得到具体值，通过reply->len得到信息长度。

  • REDIS_REPLY_ARRAY:

    • 返回数据集标识。数据集中元素的数目可以通过reply->elements获得，每个元素是个redisReply对象，元素值可以通过reply->element[..index..].*形式获得，用在获取多个数据结果的操作。

执行完命令调用后应该通过freeReplyObject()释放redisReply，对于嵌套对象（比如数组）要注意，并不需要嵌套进行释放，这样是有害的会造成内存破坏。

Important:hiredis当前版本 (0.10.0)当使用异步API时会自己释放replies对象。这意味着你使用异步API时并不需要主动调用freeReplyObject 。relpy对象当回调返回时将会被自动释放。但是这种行为也许会在将来的版本中改变，所以升级时请密切关注升级日志。

清理连接资源

断开连接并且释放context使用以下函数

void redisFree(redisContext *c);

此函数立马关闭socket并且释放创建context时分配的资源。

发送多个命令参数

和redisCommand函数相似，redisCommandArgv函数可以用于传输多个命令参数。函数原型为

void *redisCommandArgv(redisContext *c, int argc, const char **argv, const size_t *argvlen);

，类似于 lpush， del key1 key2..., zadd key score1 member1 score2 member2...这类命令， 其中 argc是传递参数的个数， argv主要用于传递的string的value, 而argvlen 是每个string的size。

此函数返回值与redisCommand相似。参考https://gist.github.com/dspezia/1455082

管线（Pipelining）

为了搞清楚Hiredis在阻塞连接下的管线操作，需要理解其内部执行过程。

当任何类似于redisCommand的函数被调用，Hiredis首先将命令格式化为redis支持的命令协议。被格式化后的命令被放入context的输出缓冲区，这个缓冲区是动态的，所以它可以容纳任意数量的命令。在命令进入输出缓冲区后，redisGetReply 函数被调用。这个函数有以下两种执行方式：

  1. 输入缓冲区非空：

    • 从输入缓冲区中尝试解析单独的reply对象并且返回reply

    • 如果没有reply能被解析，执行步骤2

  2. 输入缓冲区为空：

    • 将整个输出缓冲区写入socket

    • 从socket中读取数据直到有一个reply能被解析

Hiredis为了有效利用socket还提供了redisGetReply的接口。对于管线命令，需要完成的唯一事情就是填充输出缓冲区。有两个函数被用于执行此操作，这两个函数基本与redisCommand函数功能类似，但是他们不返回reply

void redisAppendCommand(redisContext *c, const char *format, ...);
void redisAppendCommandArgv(redisContext *c, int argc, const char **argv, const size_t *argvlen);

当这两个函数被一次或多次调用时，通过redisGetReply依次返回replies。redisGetReply的返回值要么是REDISOK或是REDISERR，REDIS_ERR意味着获得reply发生了错误，想要得到具体的错误原因可以通过err变量来获取。

以下通过一个简单例子说明管线的使用：

redisReply *reply;
redisAppendCommand(context,"SET foo bar");
redisAppendCommand(context,"GET foo");
redisGetReply(context,&reply); // reply for SET
freeReplyObject(reply);
redisGetReply(context,&reply); // reply for GET
freeReplyObject(reply);

redisGetReply这个API也可以被用来实现阻塞的订阅模式

reply = redisCommand(context,"SUBSCRIBE foo");
freeReplyObject(reply);
while(redisGetReply(context,&reply) == REDIS_OK)
{
// consume message
freeReplyObject(reply);
}

Errors

如果某些函数（如redisConnect， redisCommand（调用不成功，函数返回值为NULL或者REDIS_ERR，此时context结构体中的err成员为非零值，可能为以下几种常量

  • REDIS_ERR_IO:当创建连接时（试着写socket或者读socket）发生的I/O错误。如果你在代码中包含了errno.h头文件，你便能得到准确的错误码。

  • REDIS_ERR_EOF:redis服务端已经关闭了此连接。

  • REDIS_ERR_PROTOCOL:服务端解析协议时发生了错误。

  • REDIS_ERR_OTHER:其他错误。目前仅仅表示无法解析目标主机名的错误。

在错误情况下，可以通过context结构体中的errstr成员得到错误的确切描述。

异步API

Hiredis自带的异步API很容易和一些基于事件的库结合使用。比如和libev、ibevent的结合使用。

连接

函数redisAsyncConnect被用来和redis建立非阻塞连接。它返回redisAsyncContext的结构体，结构体的err成员用来检查在创建连接的过程中是否发生了错误。因为创建的是非阻塞的连接，内核并不能立马返回一个连接指定主机的结果。

redisAsyncContext *c = redisAsyncConnect("127.0.0.1", 6379);
if (c->err)
{
printf("Error: %s\n", c->errstr);
// handle error
}

异步Context可设置一个响应断开连接事件的回调函数，当连接断开时会相应执行。回调函数的原型为

void(const redisAsyncContext *c, int status);

在断开连接的情况下，当连接是由用户自己断开的status参数为REDISOK，如果出现了其他错误status参数为REDISERR，当错误时通过err成员可以得到准确的错误码。

当回调执行完毕后context对象会自己释放资源。此事件的回调函数给你创建一个新连接提供了便利。

一个context对象仅能设置一次断开连接的回调，如果再进行下一次设置将会返回REDIS_ERR。设置断开连接回调函数的原型为：

int redisAsyncSetDisconnectCallback(redisAsyncContext *ac, redisDisconnectCallback *fn);

发送操作命令并且响应回调事件

在异步的情况下，redis的操作指令将会被自动加入事件循环队列。由于发送命令执行的过程是异步的，当命令执行完毕后将会调用相应的回调函数。回调函数的原型为

void(redisAsyncContext *c, void *reply, void *privdata);

privdata参数是由调用者自己定义的数据类型。

以下是进行异步命令操作的函数：

int redisAsyncCommand(redisAsyncContext *ac, redisCallbackFn *fn, void *privdata,const char *format, ...);

int redisAsyncCommandArgv( redisAsyncContext *ac, redisCallbackFn *fn, void *privdata, int argc, const char **argv, const size_t *argvlen);

命令的使用方式和上面所讲的同步接口类似。执行成功返回REDIS_OK，否则返回REDIS_ERR。比如连接已经关闭的情况下再使用redisAsyncCommand向此连接执行命令就会返回REDIS_ERR。

回调执行完毕后如果reply不为空，回调执行完毕后将自动对reply的资源进行回收。

当context发生错误时回调得到的reply将为空。

断开连接

一个异步的连接可以通过下面这个函数终止

void redisAsyncDisconnect(redisAsyncContext *ac);

当这个函数被调用时，连接并不会被立即关闭，而是等待所有这个连接的异步命令操作执行完毕，并且回调事件已经执行完毕后才关闭此连接，这时在响应关闭连接事件的回调函数中得到的状态为REDIS_OK，此连接的资源也将会被自动回收。

将其挂接到事件库X

在context对象被创建后进行很少的几步操作就可以进行挂接。参看目录adapters/下是如何挂接到libev 和 libevent下的。

应答解析API

Hiredis自带的答复解析API ，可以很容易与更高层次的语言进行绑定。 TODO：


mengbo2006
关注
专栏目录
redis C API快速上手（安装及demo代码编写）
FDmitnick的博客
04-23 3332
---FD---此文章为redis上手时相关记录，现记录下来好以后查找问题~1、redis安装的相关链接，能够完成安装https://www.cnblogs.com/renzhicai/p/7773080.html2、C环境下demo编写（1）通过上文安装好之后，开始在C环境下demo编写https://blog.csdn.net/hj19870806/article/details/872490...
redis-c api
Irean_Lau的专栏
05-13 2007
原文戳redis官网https://github.com/redis/hiredis.gitredisContext *redisConnect(constchar *ip, int port); void *redisCommand(redisContext *c, constchar *format, ...); voidfreeReplyObject(void *reply);Connecti
Redis C客户端API
duoerbasilu
01-15 248
Redis安装步骤： 1.redis server安装 wget http://redis.googlecode.com/files/redis-2.4.6.tar.gz #下载文件 tar xzf redis-2.4.6.tar.gz cd redis-2.4.6 make cp src/redis-server src/redis-cli /usr/bin/ #方便在终端在任何地方...
c语言api函数参数说明,redis C语言API简单函数使用介绍
weixin_34894242的博客
05-19 251
hiredis是redis数据库的C接口，目前只能在linux下使用，几个基本的函数就可以操作redis数据库了。函数原型：redisContext *redisConnect(const char *ip, int port)说明：该函数用来连接redis数据库，参数为数据库的ip地址和端口，一般redis数据库的端口为6379该函数返回一个结构体redisContext。函数原型：void *...
C++操作redis的客户端hiredis库
10-08
为了在C++应用中与Redis进行交互，我们通常会使用客户端库，其中Hiredis是一个轻量级、高效的选项。本文将详细介绍如何在Win10环境下，使用Qt5.14.2（基于gcc 7.3.0）编译Hiredis 1.0.2库，并实现与Redis数据库的...
Redis的C客户端hiRedis.zip
07-16
hiRedis 是 Redis 官方指定的 C 语言客户端开发包，支持 Redis 完整的命令集、管线以及事件驱动编程。示例代码：redisContext *c = redisConnect("127.0.0.1", 6379); if (c->err) { printf("Error: %s\n", c->...
使用C语言客户端（hiredis）连接Redis
hcinfo_18的博客
07-07 1962
关键词：hiredis, cRedis, redis clients, redis客户端, C客户端, 华为云分布式缓存服务 hiredis是一个非常全面的C语言版redis接口库，支持所有命令、管道与脚本。华为云分布式缓存服务Redis版支持hiredis客户端连接。 使用C语言客户端(hiredis)连接Redis，需要先安装编译环境以及hiredis，以CentOS为例，介绍C客户端环境...
C++ Redis 客户端简单使用
最新发布
06-17
首先，为了在C++中与Redis进行交互，我们需要一个支持C++的Redis客户端库。常见的选择有`hiredis`，这是一个轻量级的C库，同时也提供了C++绑定。另一个是`cpp-redis`，这是一个完全用C++编写的客户端库，提供了更...
redis 和 qt hiredis
06-04
hiredis 是一个专门为 Redis 设计的 C 语言客户端库。它被设计为轻量级且高效的，减少了 I/O 调用并优化了内存使用，使得在处理 Redis 命令时性能更优。hiredis 支持同步和异步操作模式，可以很好地适应不同类型的...
redis实时数据库C语言操作程序示例
11-21
C语言编写的简单操作redis实时数据库的程序
Redis API帮助文档(中文版)
09-14
如果打不开，那你看打开时是不是提示是否每次询问，把勾选去掉即可打开
Redis C API的定义及使用方法：
ArtAndLife的博客
09-12 905
遗留问题： 数据库连接池的数量设置为多大合适？ 总结： 凡是池子，都是一个“list”；（不论是线程池还是连接池） 凡是Manager，都是一个“map”。 “池子”的成员变量也是很固定的： list m_free_list; ThreadNotify m_free_notify; int cur_conn_cnt; int max_conn_cnt; 因为池子的作用就是供他人调用，从池子中拿走一个、归还一个， list链表就是互斥区，锁是为了保护互斥区。 #Redis数据库连接池
Redis API
热门推荐
一叶知秋的博客
11-15 2万+
Redis 是一款基于内存的数据库，那么对于内存的使用是至关重要的，我们在使用一种数据结构的时候，以空间换取时间的话，可以使用一些压缩的结构，比如 hash 里面会有 ziplist。实际上对于 Redis 源码内部有一个 redisObject 这样的对象，它会有很多属性，其中比较重要的属性有两个，第一个就是数据类型（type），第二个就是编码方式（encoding），除了这两种还有数据指针（ptr）、虚拟内存（vm）和其他信息。
redis的C接口
tyro_wzp的博客
04-21 574
远程字典服务，是一个开源的使用ANSI C语言编写、支持网络、可基于内存亦可持久化的日志型、Key-Value数据库，并提供多种语言的API。2）没有原生的可扩展机制，不具有自身可扩展能力，要依赖客户端来实现分布式读/写。3）disk-backed持久化功能，跟传统意义上的持久化有比较大的区别。1）数据库容量受到物理内存的限制，不能实现海量数据的高性能读/写。4）适合的场景主要局限在较小数据量的高性能操作和运算上。2)对于读/写压力比较大，实时性要求比较高的场景下。ip:redis的IP。
Redis C++ API(hiredis)的完整使用教程
quyan的博客
07-07 6246
文章目录Redis(Linux)1. redis的安装&运行1.1. 安装1.2. 命令行启动本地运行指定ip、端口号、登陆密码运行：关闭服务2. C++ API2.1. 安装hiredis2.2. C++调用示例代码： Redis(Linux) 1. redis的安装&运行 1.1. 安装 参考官方链接，下载编译最新版redis： $ wget http://download.r...
linux下C++连接redis
feinifi的博客
02-21 2432
linux下c++连接redis,需要安装redis,同时还需要安装hiredis，hiredis是c++操作redis的api库。redis的安装这里不介绍了，很多教程。这里直接从hiredis安装说起。 1、下载hiredis，并解压。https://github.com/redis/hiredis [root@server software]# wget https://github.c...
redis使用（五）：c异步接口
悟空
02-14 2552
hredis 异步接口 libevent
Linux下编译与测试Hiredis库及Redis客户端
hiredis是Redis的C语言客户端库，用于更高效地访问Redis。用户需要通过Git克隆hiredis项目，并在项目目录下执行`make`和`make install`进行编译。编译完成后，需要将编译得到的`libhiredis.so`动态链接库复制到系统...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值