HSETNX

HSETNX key field value

Available since:

2.0.0

Time complexity:

O(1)

ACL categories:

@write, @hash, @fast,

Sets field in the hash stored at key to value, only if field does not yet exist. If key does not exist, a new key holding a hash is created. If field already exists, this operation has no effect.

Examples

redis> HSETNX myhash field "Hello"
(integer) 1
redis> HSETNX myhash field "World"
(integer) 0
redis> HGET myhash field
1) "Hello"
2) "there"
3) (nil)

RESP2/RESP3 Reply

One of the following:

• Integer reply: 0 if the field already exists in the hash and no operation was performed.
• Integer reply: 1 if the field is a new field in the hash and the value was set.