What's new in Valkey 9.0? Discover new features and improvements. Read the announcement.

ZSCAN

Iterates over members and scores of a sorted set.

Usage
ZSCAN key cursor [MATCH pattern] [COUNT count] [NOSCORES noscores]
Complexity
O(1) for every call. O(N) for a complete iteration, including enough command calls for the cursor to return back to 0. N is the number of elements inside the collection.
Since
2.8.0
ACL Categories
@read, @slow, @sortedset
Command flags
READONLY

See SCAN for ZSCAN documentation.

Replies

RESP2

Array reply: a two-element array.

  • The first element is a Bulk string reply that represents an unsigned 64-bit number, the cursor.
  • The second element is an Array reply of member/score pairs that were scanned. When NOSCORES option is on, a list of members from the sorted set.

RESP3

Array reply: a two-element array.

  • The first element is a Bulk string reply that represents an unsigned 64-bit number, the cursor.
  • The second element is an Array reply of member/score pairs that were scanned. When NOSCORES option is on, a list of members from the sorted set.

History

  • 8.0.0: Added noscores option.