ZRANK

ZRANK

ZRANK key member [WITHSCORE]

Доступно с версии:

2.0.0

Сложность по времени:

O(log(N))

Категории ACL:

@read, @sortedset, @fast,

Возвращает ранг элемента member в упорядоченном множестве, хранящемся по адресу key, с отсортированными по возрастанию баллами. Ранг (или индекс) нулевого базиса, то есть элемент с наименьшим баллом имеет ранг 0.

Необязательный аргумент WITHSCORE дополняет ответ команды баллом возвращённого элемента.

Используйте ZREVRANK, чтобы получить ранг элемента с отсортированными по убыванию баллами.

Возврат

• Если member существует в упорядоченном множестве:
  • с использованием WITHSCORE, Массивный ответ: массив, содержащий ранг и балл member.
  • без использования WITHSCORE, Целочисленный ответ: ранг member.
• Если member не существует в упорядоченном множестве или key не существует:
  • с использованием WITHSCORE, Массивный ответ: nil.
  • без использования WITHSCORE, Строковый ответ: nil.

Обратите внимание, что в RESP3 null и nullarray идентичны, но в RESP2 они различаются.

Примеры

ZADD myzset 1 "one"
ZADD myzset 2 "two"
ZADD myzset 3 "three"
ZRANK myzset "three"
ZRANK myzset "four"
ZRANK myzset "three" WITHSCORE
ZRANK myzset "four" WITHSCORE

История

• Начиная с версии Redis 7.2.0: добавлен необязательный аргумент WITHSCORE.