Skip to content
HotKVDocs

Ask the HotKV docs

Answers come only from these docs and can be wrong; check the linked pages before you rely on them.

HSETNX

Last updated 
HSETNX key field value
Group
Hash
Complexity
O(1)
Arity
4 (exactly, counting the command name)
Flags
write, fast
Keys
first 1, last 1, step 1
HotKV Cloud
All plans
On-Premise
no license needed

HSETNX stores value in field of the hash at key, but only when that field is not already present. A missing key is created. If the field exists, nothing changes.

Return value

Section titled “Return value”
Case RESP2 RESP3
Field was set Integer 1 Same
Field already existed Integer 0 Same

HSETNX replies with a WRONGTYPE error if key holds a value that is not a hash.

Examples

Section titled “Examples”
127.0.0.1:6379> HSETNX user:1 name "Ada"
(integer) 1
127.0.0.1:6379> HSETNX user:1 name "Grace"
(integer) 0
127.0.0.1:6379> HGET user:1 name
"Ada"

Compatibility

Section titled “Compatibility”

Same as Redis 7.4 and Valkey 8.

See also

Section titled “See also”

HSET, HSETEX, HEXISTS, SETNX