SORT 命令的最简单执行形式为:
SORT <key>
这个命令可以对一个包含数字值的键 key
进行排序。
以下示例展示了如何使用 SORT 命令对一个包含三个数字值的列表键进行排序:
redis> RPUSH numbers 3 1 2
(integer) 3
redis> SORT numbers
1) "1"
2) "2"
3) "3"
服务器执行 SORT numbers
命令的详细步骤如下:
numbers
列表长度相同的数组,
该数组的每个项都是一个 redis.h/redisSortObject
结构,
如图 IMAGE_CREATE_ARRAY 所示。obj
指针分别指向 numbers
列表的各个项,
构成 obj
指针和列表项之间的一对一关系,
如图 IMAGE_POINT_OBJ 所示。obj
指针所指向的列表项转换成一个 double
类型的浮点数,
并将这个浮点数保存在相应数组项的 u.score
属性里面,
如图 IMAGE_SET_SCORE 所示。u.score
属性的值,
对数组进行数字值排序,
排序后的数组项按 u.score
属性的值从小到大排列,
如图 IMAGE_SORTED 所示。obj
指针所指向的列表项作为排序结果返回给客户端:
程序首先访问数组的索引 0
,
返回 u.score
值为 1.0
的列表项 "1"
;
然后访问数组的索引 1
,
返回 u.score
值为 2.0
的列表项 "2"
;
最后访问数组的索引 2
,
返回 u.score
值为 3.0
的列表项 "3"
。其他 SORT <key>
命令的执行步骤也和这里给出的 SORT numbers
命令的执行步骤类似。
以下是 redisSortObject
结构的完整定义:
typedef struct _redisSortObject {
// 被排序键的值
robj *obj;
// 权重
union {
// 排序数字值时使用
double score;
// 排序带有 BY 选项的字符串值时使用
robj *cmpobj;
} u;
} redisSortObject;
SORT 命令为每个被排序的键都创建一个与键长度相同的数组,
数组的每个项都是一个 redisSortObject
结构,
根据 SORT 命令使用的选项不同,
程序使用 redisSortObject
结构的方式也不同,
稍后介绍 SORT 命令的各种选项时我们会看到这一点。