3.8 redis-C-API

网址:

下载：

git clone https://github.com/redis/hiredis.git

安装

cd hiredis
make
sudo make install

安装输出

mkdir -p /usr/local/include/hiredis /usr/local/lib
cp -a hiredis.h async.h read.h sds.h adapters /usr/local/include/hiredis cp -a libhiredis.so /usr/local/lib/libhiredis.so.0.13
cd /usr/local/lib && ln -sf libhiredis.so.0.13 libhiredis.so
cp -a libhiredis.a /usr/local/lib
mkdir -p /usr/local/lib/pkgconfig
cp -a hiredis.pc /usr/local/lib/pkgconfig

默认库安装在"/usr/local/lib/",设置加载库路径

vim ~/.bashrc

最后一行写入

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib/

重启终端

API

redisContext *redisConnect(const char *ip, int port);

说明:该函数用来连接redis数据库,参数为数据库的ip地址和端口,一般redis数据库的端口为6379 该函数返回一个结构体 redisContext。

void *redisCommand(redisContext *c, 
const char *format, ...);

说明:该函数执行命令,就如sql数据库中的SQL语句一样,只是执行的是redis数据库中的操作命令,第一个参数为连接数据库时返回的redisContext,剩下的参数为变参,就如C标准函数printf函数一样的变参。返回值为void*,一般强制转换成为redisReply类型的进行进一步的处理。

redisCommand函数返回一个东西叫redisReply，我们需要通过判断它的type字段来知道返回了具体什么样的内容：

状态标识	含义
REDIS_REPLY_STATUS	表示状态，内容通过str字段查看，字符串长度是len字段
REDIS_REPLY_ERROR	表示出错，查看出错信息，如上的str,len字段
REDIS_REPLY_INTEGER	返回整数，从integer字段获取值
REDIS_REPLY_NIL	没有数据返回
REDIS_REPLY_STRING	返回字符串，查看str,len字段
REDIS_REPLY_ARRAY	返回一个数组，查看elements的值（数组个数），通过 element[index]的方式访问数组元素，每个数组元素是一个redisReply对象的指针。

void freeReplyObject(void *reply);

说明:释放redisCommand执行后返回的redisReply所占用的内存

redisReply返回结果处理：

标识	含义
REDIS_OK	正常
REDIS_ERR_IO	IO读/写出现异常，通过errno查看原因
REDIS_ERR_EOF	服务器关闭了链接，读结束
REDIS_ERR_PROTOCOL	分析redis协议内容出错
EDIS_ERR_OTHER	其他未知的错误

上述错误类型都可以通过redisReply的errstr字段查看简短的描述

void redisFree(redisContext *c);

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

测试用例

#include <stdio.h>
#include <stdlib.h> 
#include <stddef.h> 
#include <stdarg.h> 
#include <string.h> 
#include <assert.h> 
#include <hiredis/hiredis.h>

void doTest() {
     //redis默认监听端口为6387，可以在配置文件中修改
    redisContext* c = redisConnect("127.0.0.1", 6379);
    if ( c->err)
    {
        redisFree(c);
        printf("Connect to redisServer faile\n"); 
        return ;
    }

    printf("Connect to redisServer Success\n");

    const char* command1 = "set key1 itcast_1"; 
    redisReply* r = (redisReply*)redisCommand(c, command1);
    if( NULL == r) {
        printf("Execut command1 failure\n"); 
        redisFree(c);
        return;
    }
    if( !(r->type == REDIS_REPLY_STATUS && strcasecmp(r->str,"OK")==0)) {
        printf("Failed to execute command[%s]\n",command1); 
        freeReplyObject(r);
        redisFree(c);
        return;
    }
    freeReplyObject(r);
    printf("Succeed to execute command[%s]\n", command1);

    const char* command2 = "strlen key1";
    r = (redisReply*)redisCommand(c, command2); 
    if ( r->type != REDIS_REPLY_INTEGER) {
        printf("Failed to execute command[%s]\n",command2); 
        freeReplyObject(r);
        redisFree(c);
        return;
    }
    intlength= r->integer;
    freeReplyObject(r);
    printf("The length of 'key1' is %d.\n", length); 
    printf("Succeed to execute command[%s]\n", command2);

    const char* command3 = "get key1";
    r = (redisReply*)redisCommand(c, command3); 

    if ( r->type != REDIS_REPLY_STRING)
    {
        printf("Failed to execute command[%s]\n",command3); 
        freeReplyObject(r);
        redisFree(c);
        return;
    }
    printf("The value of 'key1' is %s\n", r->str); 
    freeReplyObject(r);
    printf("Succeed to execute command[%s]\n", command3);

    const char* command4 = "get key2";
    r = (redisReply*)redisCommand(c, command4); 

    if ( r->type != REDIS_REPLY_NIL)
    {
        printf("Failed to execute command[%s]\n",command4); 
        freeReplyObject(r);
        redisFree(c);
        return;
    }
    freeReplyObject(r);
    printf("Succeed to execute command[%s]\n", command4);

    redisFree(c); 
}

int main(void)
{
    doTest();
    return 0;
}

编译：

gcc testredis.c -lhiredis -o testredis

运行：

./testredis

3.8 redis-C-API

3.8 redis-C-API

API

测试用例

results matching ""

No results matching ""