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 命令的各种选项时我们会看到这一点。