Redis Hincrby コマンド

Redis ハッシュ(Hash)

Redis Hincrby コマンドは、ハッシュテーブルのフィールド値に指定された増分値を加算するために使用されます。

増分は負の数にすることもでき、指定されたフィールドに対して減算操作を行うのと同じです。

ハッシュテーブルのキーが存在しない場合、新しいハッシュテーブルが作成され、HINCRBY コマンドが実行されます。

指定されたフィールドが存在しない場合、コマンドを実行する前にフィールドの値は 0 に初期化されます。

文字列値を格納しているフィールドに対して HINCRBY コマンドを実行すると、エラーが発生します。

この操作の値は、64 ビットの符号付き数値表現の範囲内に制限されています。

構文

redis Hincrby コマンドの基本的な構文は次のとおりです：

redis 127.0.0.1:6379> HINCRBY KEY_NAME FIELD_NAME INCR_BY_NUMBER

利用可能バージョン

>= 2.0.0

戻り値

HINCRBY コマンドを実行した後、ハッシュテーブル内のフィールドの値。

例

redis> HSET myhash field 5
(integer) 1
redis> HINCRBY myhash field 1
(integer) 6
redis> HINCRBY myhash field -1
(integer) 5
redis> HINCRBY myhash field -10
(integer) -5
redis>

Redis ハッシュ(Hash)

その他の拡張