对象 RedisSortedSet

Redis 数据库客户端 SortedSet 对象，此对象为包含指定 key 的客户端，只有调用其方法才会操作数据库

用以操作 Redis 的 SortedSet 对象，创建方法：

1
2
3
var db = require("db");
var rdb = new db.openRedis("redis-server");
var set = rdb.getSortedSet("test");

继承关系

成员函数

add

将一个或多个 member 元素及其 score 值加入到有序集当中

1
Integer RedisSortedSet.add(Object sms);

调用参数:

• sms: Object, 指定要添加的 member/score 对象

返回结果:

• Integer, 被成功添加的新成员的数量，不包括那些被更新的、已经存在的成员

---

将一个或多个 member 元素及其 score 值加入到有序集当中

1
Integer RedisSortedSet.add(...sms);

调用参数:

• sms: ..., 指定要添加的 member/score 列表

返回结果:

• Integer, 被成功添加的新成员的数量，不包括那些被更新的、已经存在的成员

---

score

返回有序集中，成员 member 的 score 值

1
Buffer RedisSortedSet.score(Buffer member);

调用参数:

• member: Buffer, 指定要查询的 member

返回结果:

• Buffer, member 成员的 score 值，以字符串形式表示

---

incr

为有序集的成员 member 的 score 值加上增量 num

1
2
Buffer RedisSortedSet.incr(Buffer member,
    Long num = 1);

调用参数:

• member: Buffer, 指定要修改的 member
• num: Long, 指定要加上的数值

返回结果:

• Buffer, member 成员的新 score 值，以字符串形式表示

---

remove

移除有序集中的一个或多个 member 元素

1
Integer RedisSortedSet.remove(Array members);

调用参数:

• members: Array, 指定要移除的元素数组

返回结果:

• Integer, 被成功移除的元素的数量，不包括被忽略的元素

---

移除有序集中的一个或多个 member 元素

1
Integer RedisSortedSet.remove(...members);

调用参数:

• members: ..., 指定要移除的元素列表

返回结果:

• Integer, 被成功移除的元素的数量，不包括被忽略的元素

---

len

返回有序集中元素的数量

1
Integer RedisSortedSet.len();

返回结果:

• Integer, 返回有序集的长度

---

count

返回有序集中， score 值在 min 和 max 之间(默认包括 score 值等于 min 或 max )的成员的数量

1
2
Integer RedisSortedSet.count(Integer min,
    Integer max);

调用参数:

• min: Integer, 指定统计的最小 score
• max: Integer, 指定统计的最大 score

返回结果:

• Integer, score 值在 min 和 max 之间的成员的数量

---

range

返回有序集中，指定区间内的成员，成员的位置按 score 值递增(从小到大)来排序

1
2
3
NArray RedisSortedSet.range(Integer start,
    Integer stop,
    Boolean withScores = false);

调用参数:

• start: Integer, 指定查询的起始下标，0 表示第一个元素，-1 表示最后一个元素
• stop: Integer, 指定查询的结束下标，0 表示第一个元素，-1 表示最后一个元素
• withScores: Boolean, 指定是否在结果中包含 score

返回结果:

• NArray, 指定区间内，带有 score 值(可选)的有序集成员的列表

---

rangeRev

返回有序集中，指定区间内的成员，成员的位置按 score 值递减(从大到小)来排序

1
2
3
NArray RedisSortedSet.rangeRev(Integer start,
    Integer stop,
    Boolean withScores = false);

调用参数:

• start: Integer, 指定查询的起始下标，0 表示第一个元素，-1 表示最后一个元素
• stop: Integer, 指定查询的结束下标，0 表示第一个元素，-1 表示最后一个元素
• withScores: Boolean, 指定是否在结果中包含 score

返回结果:

• NArray, 指定区间内，带有 score 值(可选)的有序集成员的列表

---

rank

有序集中成员 member 的排名。其中有序集成员按 score 值递增(从小到大)顺序排列

1
Integer RedisSortedSet.rank(Buffer member);

调用参数:

• member: Buffer, 指定要查询的 member

返回结果:

• Integer, member 如果 member 是有序集 key 的成员，返回 member 的排名。如果 member 不是有序集 key 的成员，返回 nil

---

rankRev

有序集中成员 member 的排名。其中有序集成员按 score 值递减(从大到小)顺序排列

1
Integer RedisSortedSet.rankRev(Buffer member);

调用参数:

• member: Buffer, 指定要查询的 member

返回结果:

• Integer, member 如果 member 是有序集 key 的成员，返回 member 的排名。如果 member 不是有序集 key 的成员，返回 nil

---

toString

返回对象的字符串表示，一般返回 "[Native Object]"，对象可以根据自己的特性重新实现

1
String RedisSortedSet.toString();

返回结果:

• String, 返回对象的字符串表示

---

toJSON

返回对象的 JSON 格式表示，一般返回对象定义的可读属性集合

1
Value RedisSortedSet.toJSON(String key = "");

调用参数:

• key: String, 未使用

返回结果:

• Value, 返回包含可 JSON 序列化的值