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
valkey-protocol(7) Integer reply: the 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)