zremrangebyrank.3valkey - Man Page
Removes members in a sorted set within a range of indexes. Deletes the sorted set if all members were removed.
Synopsis
ZREMRANGEBYRANK
key start stop
Description
Removes all elements in the sorted set stored at key
with rank between start
and stop
. Both start
and stop
are 0
-based indexes with 0
being the element with the lowest score. These indexes can be negative numbers, where they indicate offsets starting at the element with the highest score. For example: -1
is the element with the highest score, -2
the element with the second highest score and so forth.
Reply
Resp2
valkey-protocol(7) Integer reply: the number of members removed.
Resp3
valkey-protocol(7) Integer reply: Number of members removed.
Complexity
O(log(N)+M) with N being the number of elements in the sorted set and M the number of elements removed by the operation.
Acl Categories
@slow @sortedset @write
History
- Available since: 2.0.0
Examples
127.0.0.1:6379> ZADD myzset 1 "one" (integer) 1 127.0.0.1:6379> ZADD myzset 2 "two" (integer) 1 127.0.0.1:6379> ZADD myzset 3 "three" (integer) 1 127.0.0.1:6379> ZREMRANGEBYRANK myzset 0 1 (integer) 2 127.0.0.1:6379> ZRANGE myzset 0 -1 WITHSCORES 1) "three" 2) "3"
See Also
bzmpop(3valkey), bzpopmax(3valkey), bzpopmin(3valkey), zadd(3valkey), zcard(3valkey), zcount(3valkey), zdiff(3valkey), zdiffstore(3valkey), zincrby(3valkey), zinter(3valkey), zintercard(3valkey), zinterstore(3valkey), zlexcount(3valkey), zmpop(3valkey), zmscore(3valkey), zpopmax(3valkey), zpopmin(3valkey), zrandmember(3valkey), zrange(3valkey), zrangestore(3valkey), zrank(3valkey), zrem(3valkey), zremrangebylex(3valkey), zremrangebyscore(3valkey), zrevrank(3valkey), zscan(3valkey), zscore(3valkey), zunion(3valkey), zunionstore(3valkey)