HINCRBY
This page documents the preview (v2.21) version. Preview includes features under active development and is for development and testing only. For production, use the stable (v2024.1) version.
Synopsis
HINCRBY key field delta
This command adds delta to the number that is associated with the given field field for the hash key. The numeric value must a 64-bit signed integer.
- If the
keydoes not exist, a new hash container is created. If the fieldfielddoes not exist in the hash container, the associated string is set to "0". - If the given
keyis not associated with a hash type, or if the string associated withfieldcannot be converted to an integer, an error is raised.
Return value
Returns the value after addition.
Examples
$ HSET yugahash f1 5
1
$ HINCRBY yugahash f1 3
8
$ HINCRBY yugahash non-existent-f2 4
4
$ HINCRBY non-existent-yugahash f1 3
3
See also
hexists, hget, hgetall, hkeys, hlen, hmget, hmset, hset, hincrby, hstrlen, hvals