FarelDB 键值对命令 集合操作类(set) 之 SRANDMEMBER KEY
Srandmember 命令用于返回集合中的一个随机元素。
Srandmember 命令接受可选的 count 参数:
如果 count 为正数,且小于集合基数,那么命令返回一个包含 count 个元素的数组,数组中的元素各不相同。如果 count 大于等于集合基数,那么返回整个集合。
如果 count 为负数,那么命令返回一个数组,数组中的元素可能会重复出现多次,而数组的长度为 count 的绝对值。
该操作和 SPOP 相似,但 SPOP 将随机元素从集合中移除并返回,而 Srandmember 则仅仅返回随机元素,而不对集合进行任何改动。
语法
FarelDB 127.0.0.1:6800 > SRANDMEMBER KEY [count]
返回值
只提供集合 key 参数时,返回一个元素;如果集合为空,返回 nil 。 如果提供了 count 参数,那么返回一个数组;如果集合为空,返回空数组。
命令实例
打开一个命令行窗口,启动FarelDB服务端,再打开一个命令行窗口,启动FarelDB客户端,输入以下命令:
FarelDb 127.0.0.1:6800 > del num
1
(0 ms)
FarelDb 127.0.0.1:6800 > sadd num 1 2 3 4 5 6 7
7
(0 ms)
FarelDb 127.0.0.1:6800 > srandmember num 1
1) "6"
(1 ms)
FarelDb 127.0.0.1:6800 > srandmember num 7
1) "1"
2) "2"
3) "3"
4) "4"
5) "5"
6) "6"
7) "7"
(0 ms)
FarelDb 127.0.0.1:6800 > srandmember num -5
1) "6"
2) "2"
3) "3"
4) "1"
5) "2"
API 说明
函数原型
FarelDbKvRes* queryKv(std::string Command)
输入参数说明
输入参数 | 描述 | 可选 |
---|---|---|
Command | SRANDMEMBER KEY [count] 语法字符串 | 否 |
返回参数说明
调用成功返回
返回参数 | 值 | 含义 |
---|---|---|
FarelDbKvRes->errorInfos.size() | 0 | 调用成功,无错误信息 |
调用异常返回
返回参数 | 值 | 含义 |
---|---|---|
FarelDbKvRes->errorInfos.size() | 大于0 | 调用失败,errorInfos对象数组包含1个或多个错误信息 |
FarelDbKvRes->errorInfos[0]->resCode | 大于0的数值 | 调用失败,返回错误代码 |
FarelDbKvRes->errorInfos[0]->resInfo | 非空字符串 | 调用失败,返回错误信息字符串 |
返回数据获取方法
FarelDbKvRes* queryKv(std::string stringCommand)接口调用成功后,接口将不同种类命令需要返回的不同种类数据集存储在FarelDbKvRes的众多不同子类对象中返回给调用者,调用者可以根据不同的命令类型将接口返回的父类FarelDbKvRes指针转换成具体存储返回数据集的子类对象指针来取得数据集,具体获取方法,请参考下面的样例代码。
时间复杂度
O(logN)
样例代码
#include <iostream>
#include <functional>
#include <memory>
#include "fareldb_connection.h"
using namespace std;
using namespace fareldb_connection;
int main(int argc,char *argv[])
{
//创建连接
FarelDbConnection conn;
//连接
tuple<int, string> resConn = conn.connect("127.0.0.1", 6800, "root", "root");
//连接失败
if (0 != get<0>(resConn))
{
printf("调用失败,错误代码:%d : 错误信息:%s\n", get<0>(resConn), get<1>(resConn).c_str());
return;
}
//连接成功
//集合myset1添加
string kvCommand = u8"SADD num 1 2 3 4 5 6 7";//命令需要使用utf8字符串
//执行命令
std::shared_ptr<FarelDbKvRes> res(conn.queryKv(kvCommand));
//执行失败
if (res->errorInfos.size() > 0)
{
printf("调用失败,错误代码:%d ; 错误信息: %s \n", res->errorInfos[0]->resCode, res->errorInfos[0]->resInfo.c_str());
return;
}
kvCommand = u8"SRANDMEMBER num 2";//命令需要使用utf8字符串
//执行命令
res = std::shared_ptr<FarelDbKvRes>(conn.queryKv(kvCommand));
if (res->errorInfos.size() > 0)
{
//调用失败,输出错误代码和错误信息
printf("调用失败,错误代码:%d ; 错误信息: %s \n", res->errorInfos[0]->resCode, res->errorInfos[0]->resInfo.c_str());
return;
}
//调用成功,不同命令返回不同类型数据集,不同的数据集分类存储在不同子类之中
if (FARELDB_KV_RES_ELEMENTLIST == res->getType())
{
// 父类智能指针转子类智能指针,通过子类获取命令返回数据集
std::shared_ptr<FarelDbKvResElementList> resData(std::dynamic_pointer_cast<FarelDbKvResElementList>(res));
for (int i = 0; i < resData->vals.size(); i++)
{
//key值不存在则返回空指针;存在则返回key的值
string rtn = (nullptr == resData->vals[i]) ? "nil" : resData->vals[i]->data;
printf("调用成功: %s,返回:%s \n", kvCommand.c_str(), rtn.c_str());
}
}
else
{
printf("正确返回类型为:%d, 调用返回类型不匹配,返回类型错误:%d \n", FARELDB_KV_RES_ELEMENTLIST, res->getType());
}
}
补充说明
无