English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Redis Incrby コマンド

Redis 文字列(string)

Redis Incrby コマンドは、キーに保存されている数字に指定された増分値を加算します。

key が存在しない場合、keyの値はINCRBYコマンドを実行する前に0に初期化されます。

値に誤ったタイプが含まれている場合、または文字列型の値が数字として表現できない場合、エラーを返します。

この操作の値の制限は 64 ビット(bit)の符号付き数値を表現する範囲内で。

语法

redis Incrby コマンドの基本的な语法は以下の通りです:

redis 127.0.0.1:6379> INCRBY KEY_NAME INCR_AMOUNT

利用可能バージョン

>= 1.0.0

戻り値

指定された増分値を加えた後の、keyの値。

オンラインサンプル

# 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
(エラー) ERR value is not an integer or out of range

Redis 文字列(string)