SSDB PHP程序api文档

法通过返回值来判断被删除的 key 是否存在.示例$ssdb->zdel('hz, 'key');zincr说明使 zset 中的 key 对应的值增加 num. 参数 num 可以为负数. 如果原来的值不是整数(字符串形式的整数), 它会被先转换成整数.参数name - zset 的名字.key -num - 必须是有符号整数.返回值如果出错则返回 false, 否则返回新的值.示例$ssdb->zincr('z', 'key', 1);zexists说明判断指定的 key 是否存在于 zset 中.参数name - zset 的名字.key -返回值如果存在, 返回 true, 否则返回 false.示例$ssdb->zexists('z', 'key');zsize说明返回 zset 中的元素个数.参数name - zset 的名字.返回值出错则返回 false, 否则返回元素的个数, 0 表示不存在 zset(空).示例$ssdb->zsize('z');zlist, zrlist说明列出名字处于区间 (name_start, name_end] 的 zset.("", ""] 表示整个区间.参数name_start - 返回的起始名字(不包含), 空字符串表示 -inf.name_end - 返回的结束名字(包含), 空字符串表示 +inf.limit - 最多返回这么多个元素.返回值出错则返回 false, 否则返回包含名字的数组.示例$ssdb->zlist('a', 'z', 10);zkeys说明列出 zset 中的 key 列表. 参见 zscan().参数name - zset 的名字.key_start - 参见 zscan().score_start - 参见 zscan().score_end - 参见 zscan().limit - 最多返回这么多个元素.返回值如果出错则返回 false, 否则返回包含 key 的数组.示例$ssdb->zkeys('z', '', 1, 100, 10);zscan说明列出 zset 中处于区间 (key_start+score_start, score_end] 的 key-score 列表. 如果 key_start 为空, 那么对应权重值大于或者等于 score_start 的 key 将被返回. 如果 key_start 不为空, 那么对应权重值大于 score_start 的 key, 或者大于 key_start 且对应权重值等于 score_start 的 key 将被返回.也就是说, 返回的 key 在 (key.score == score_start && key > key_start || key.score > score_start), 并且 key.score <= score_end 区间. 先判断 score_start, score_end, 然后判断 key_start.("", ""] 表示整个区间.参数name - zset 的名字.key_start - score_start 对应的 key.score_start - 返回 key 的最小权重值(可能不包含, 依赖 key_start), 空字符串表示 -inf.score_end - 返回 key 的最大权重值(包含), 空字符串表示 +inf.limit - 最多返回这么多个元素.返回值如果出错则返回 false, 否则返回包含 key-score 的关联数组.示例$ssdb->zscan('z', '', 1, 100, 10);遍历 zset:$key_start = ''; $score_start = ''; while(1){ $items = $ssdb->zscan($zname, $key_start, $score_start, '', 10); if(!$items){ break; } foreach($items as $key=>$score){ // process($key, $score)... // 记住最大的元素和它的权重 $key_start = $key; $score_start = $score;} }zrscan说明列出 zset 中的 key-score 列表, 反向顺序. 参见 zkeys().参数name - zset 的名字.key_start - 参见 zkeys().score_start - 参见 zkeys().score_end - 参见 zkeys().limit - 最多返回这么多个元素.返回值如果出错则返回 false, 否则返回包含 key-score 的关联数组.示例$ssdb->zrscan('z', '', 100, 1, 10);zrank, zrrank说明注意! 本方法可能会非常慢! 请在离线环境中使用.返回指定 key 在 zset 中的排序位置(排名), 排名从 0 开始. zrrank 获取是是倒序排名.参数name - zset 的名字.key -返回值found.出错则返回 false, null 表示 key 不存在于 zset, 否则返回排名.示例$ssdb->zrank('z', 'k1');zrange, zrrange说明注意! 本方法在 offset 越来越大时, 会越慢!根据下标索引区间 [offset, offset + limit) 获取 key-score 对, 下标从 0 开始. zrrange 是反向顺序获取.参数name - zset 的名字.offset - 正整数, 从此下标处开始返回. 从 0 开始.limit - 正整数, 最多返回这么多个 key-score 对.返回值如果出错则返回 false, 否则返回包含 key-score 的关联数组.示例$ssdb->zrange('z', 0, 10);zclear说明删除 zset 中的所有 key.参数name - zset 的名字.返回值如果出错则返回 false, 否则返回删除的 key 的数量.示例$ssdb->zclear('z');zcount说明返回处于区间 [start,end] key 数量.参数name - zset 的名字.score_start - key 的最小权重值(包含), 空字符串表示 -inf.score_end - key 的最大权重值(包含), 空字符串表示 +inf.返回值如果出错则返回 false, 否则返回符合条件的 key 的数量.示例$ssdb->zcount('z', 0, 100);zsum说明返回 key 处于区间 [start,end] 的 score 的和.参数name - zset 的名字.score_start - key 的最小权重值(包含), 空字符串表示 -inf.score_end - key 的最大权重值(包含), 空字符串表示 +inf.返回值如果出错则返回 false, 否则返回符合条件的 score 的求和.示例$ssdb->zsum('z', 0, 100);zavg说明返回 key 处于区间 [start,end] 的 score 的平均值.参数name - zset 的名字.score_start - key 的最小权重值(包含), 空字符串表示 -inf.score_end - key 的最大权重值(包含), 空字符串表示 +inf.返回值如果出错则返回 false, 否则返回符合条件的 score 的平均值.示例$ssdb->zavg('z', 0, 100);zremrangebyrank说明删除位置处于区间 [start,end] 的元素.参数name - zset 的名字.start - (包含).end -(包含).返回值出错则返回 false, 否则返回被删除的元素个数.示例$ssdb->zremrangebyrank('z', 1, 2);zremrangebyscore说明删除权重处于区间 [start,end] 的元素.参数name - zset 的名字.start - (包含).end -(包含).返回值出错则返回 false, 否则返回被删除的元素个数.示例$ssdb->zremrangebyscore('z', 1, 2);zpop_front说明从 zset 首部删除并返回 limit 个元素.参数name - zset 的名字.limit - 正整数, 最多要删除并返回这么多个 key-score 对.返回值如果出错则返回 false, 否则返回包含 key-score 的关联数组.示例$ssdb->zpop_front('z', 3);zpop_back说明从 zset 尾部删除并返回 limit 个元素.参数name - zset 的名字.limit - 正整数, 最多要删除并返回这么多个 key-score 对.返回值如果出错则返回 false, 否则返回包含 key-score 的关联数组.示例$ssdb->zpop_back('z', 3);multi_zset说明批量设置 zset 中的 key-score.参数name - zset 的名字.kvs - 包含 key-score 的关联数组 .返回值出错则返回 false, 其它值表示正常.示例$ssdb->multi_zset('z