Redis Incrby-Befehl

Redis-Strings

Der Redis-Incrby-Befehl addiert den angegebenen Inkrementwert zu der in key gespeicherten Zahl.

Wenn key nicht existiert, wird der Wert von key zuerst auf 0 initialisiert, bevor der Befehl INCRBY ausgeführt wird.

Wenn der Wert den falschen Typ enthält oder wenn ein String-Wert nicht als Zahl dargestellt werden kann, wird ein Fehler zurückgegeben.

Der Wert in diesem Vorgang ist auf die Darstellung als vorzeichenbehaftete 64-Bit-Ganzzahl beschränkt.

Syntax

Die grundlegende Syntax des Redis-Incrby-Befehls lautet wie folgt:

redis 127.0.0.1:6379> INCRBY KEY_NAME INCR_AMOUNT

Verfügbare Versionen

>= 1.0.0

Rückgabewert

Der Wert von key, nachdem der angegebene Inkrementwert addiert wurde.

Beispiel

# key 存在且是数字值

redis> SET rank 50
OK

redis> INCRBY rank 20
(integer) 70

redis> GET rank
"70"


# key 不存在时

redis> EXISTS counter
(integer) 0

redis> INCRBY counter 30
(integer) 30

redis> GET counter
"30"


# key 不是数字值时

redis> SET book "long long ago..."
OK

redis> INCRBY book 200
(error) ERR value is not an integer or out of range

Redis-Strings

Andere Erweiterungen