FarelDB 第6章 第6讲 键值对命令 有序集合操作类(sorted set) 之 ZLEXCOUNT key min max

FarelDB 键值对命令 有序集合操作类(sorted set) 之 ZLEXCOUNT KEY MIN MAX

Zlexcount 命令在计算有序集合中指定字典区间内成员数量。

语法

FarelDB 127.0.0.1：6800 >  ZLEXCOUNT KEY MIN MAX

指令     | 说明  
-------- | -----  
ZLEXCOUNT	|	指令
KEY       	|	有序集合键名称
MIN	        |	在有序集合中字典序排名较小的成员
MAX	        |	在有序集合中字典序排名较大的成员

补充说明:
1. 成员名称前可加 [或（ 符号作为开头, [ 或（符号与成员之间不能有空格，不加等同于加[
2. 可以使用 - 和 + 表示得分最小值和最大值
3. min 和 max 不能反, max 放前面 min放后面会导致返回结果为0
4. 计算成员之间的成员数量时,参数 min 和 max 的位置也计算在内。
5. min 和 max 参数的含义与 zrangebylex 命令中所描述的相同
6  [ 是闭区间符号
   [min 表示返回的结果中包含 min 值
   [max 表示返回的结果中包含 max 值
7  ( 是开区间符号
   (min 表示返回的结果中不包含 min 值
   (max 表示返回的结果中不包含 max 值
8  [MIN, [MAX 可以用-,+ 代替
   - 表示得分最小值的成员
   + 表示得分最大值的成员
   
补充说明：
字面上说该函数返回有序集合中处于该字典区间的范围的元素的个数，下边给出返回值是如何计算出来的计算逻辑：
按照字典（英文字母字典排序）序列限制min和max区间。
注意使用字典序列返回区间的所有函数的使用隐含前提是该有序集合内的所有元素的分数相同，在有序集合中相同分数的元素之间的顺序是通过字典序排列的，比如c=10，再插入a=10，a的顺序会排列在c之前。
字典序确定区间的函数都基于这个前置条件，查找时如果从有序集中的第一个元素开始，依次和max进行比较；如果从最后一个元素开始，依次和min进行比较，确定两边边界后返回元素的数量。
所以对于分数不相同的有序集合使用字典序相关的所有函数都是不恰当的，返回结果可能不准确。

返回值

有序集合中成员名称 min 和 max 之间的成员数量; Integer类型。

命令实例

打开一个命令行窗口，启动FarelDB服务端，再打开一个命令行窗口，启动FarelDB客户端，输入以下命令：

#计算成员之间成员数量
FarelDb 127.0.0.1:6800 >  zadd word 0 apple 0 bed 0 cat 0 doll 0 egg 0 full 0 good
7
(0 ms)  
FarelDb 127.0.0.1:6800 > del word
1
(0 ms)
FarelDb 127.0.0.1:6800 >  zadd word 0 apple 0 bed 0 cat 0 doll 0 egg 0 full 0 good
7
(0 ms)
FarelDb 127.0.0.1:6800 > zlexcount word - +
7
(0 ms)
FarelDb 127.0.0.1:6800 > zlexcount word [bed [full
5
(0 ms)

---

API 说明

函数原型

FarelDbKvRes* queryKv(std::string Command)

输入参数说明

输入参数	描述	可选
Command	RPUSHX KEY_NAME VALUE1…VALUEN 语法字符串	否

返回参数说明

调用成功返回

返回参数	值	含义
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;
	}
	//连接成功

	//集合添加元素 
	string kvCommand = u8"ZADD myzset 0 a 0 b 0 c 0 d 0 e 0 f 0 g";//命令需要使用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"ZLEXCOUNT myzset - +";//命令需要使用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_ULONG == res->getType())
	{
		// 父类智能指针转子类智能指针，通过子类获取命令返回数据集 
		std::shared_ptr<FarelDbKvResUlong> resData(std::dynamic_pointer_cast<FarelDbKvResUlong>(res));
		printf("%s 调用成功,返回值是%d \n", kvCommand.c_str(), resData->val);
	}
	else
	{
		printf("正确返回类型为：%d, 调用返回类型不匹配，返回类型错误：%d \n", FARELDB_KV_RES_ULONG, res->getType());
	}
}

补充说明

字面上说该函数返回有序集合中处于该字典区间的范围的元素的个数，下边给出返回值是如何计算出来的计算逻辑：
按照字典（英文字母字典排序）序列限制min和max区间，注意使用字典序列返回区间的所有函数的使用隐含前提是该有序集合内的所有
元素的分数相同，在有序集合中相同分数的元素之间的顺序是通过字典序排列的，比如c=10，再插入a=10，a的顺序会排列在a之前，所以
字典序确定区间的函数都基于这个前置条件，查找时从有序集中的第一个元素开始，依次和max进行比较，从最后一个元素开始，依次和
min进行比较，确定两边边界后返回元素的数量所以对于分数不相同的有序集合使用字典序相关的所有函数都是不恰当的。