Команда Incrby Redis

Строки (string) Redis

Команда Incrby Redis добавляет указанное значение к хранящемуся в ключе числу.

Если ключ не существует, то значение ключа будет сначала инициализировано в 0, а затем выполнен командой INCRBY.

Если значение содержит неправильный тип или строковое значение не может быть представлено как число, то возвращается ошибка.

Значение операции ограничено в пределах 64-битного знакового целого числа.

Грамматика

Основная грамматика команды redis Incrby:

redis 127.0.0.1:6379> INCRBY KEY_NAME INCR_AMOUNT

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

>= 1.0.0

Возвратное значение

Возвращает значение ключа после добавления указанного значения increments.

Онлайн пример

# ключ существует и является значением типа числа
redis> SET rank 50
OK
redis> INCRBY rank 20
(integer) 70
redis> GET rank
"70"
# ключ не существует
redis> EXISTS counter
(integer) 0
redis> INCRBY counter 30
(integer) 30
redis> GET counter
"30"
# ключ не является значением типа числа
redis> SET book "long long ago..."
OK
redis> INCRBY book 200
(ошибка) ERR значение не является целым числом или выходит за пределы диапазона

Строки (string) Redis