VRANGE

VRANGE key start end [count]

Available since:

Redis Open Source 8.4.0

Time complexity:

O(log(K)+M) where K is the number of elements in the start prefix, and M is the number of elements returned. In practical terms, the command is just O(M)

The VRANGE command provides a stateless iterator for the elements inside a vector set. It allows you to retrieve all the elements inside a vector set in small amounts for each call, without an explicit cursor, and with guarantees about what you will miss in case the vector set is changing (elements added and/or removed) during the iteration.

The command returns elements in lexicographical order, using byte-by-byte comparison (like memcmp()) to establish a total order among elements.

Required arguments

Optional arguments

Examples

Retrieve the first 10 elements starting from the string "Redis" (inclusive):

VRANGE word_embeddings [Redis + 10

Iterate through all elements, 10 at a time:

VRANGE mykey - + 10

Continue iteration from the last element of the previous result (exclusive):

VRANGE mykey (a7 + 10

Return all elements in the set (use with caution):

VRANGE mykey - + -1

Return information

Behavior

• Iteration guarantees: Each range will produce exactly the elements that were present in the range at the moment the VRANGE command was executed.
• Concurrent modifications: Elements removed or added during iteration may or may not be returned, depending on when they were modified.
• Empty key: If the key doesn't exist, returns an empty array.