hsetnx.3valkey - Man Page

HSETNX key field value

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.

One of the following:

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

O(1)

@fast @hash @write

• Available since: 2.0.0

127.0.0.1:6379> HSETNX myhash field "Hello"
(integer) 1
127.0.0.1:6379> HSETNX myhash field "World"
(integer) 0
127.0.0.1:6379> HGET myhash field
"Hello"

hdel(3valkey), hexists(3valkey), hget(3valkey), hgetall(3valkey), hincrby(3valkey), hincrbyfloat(3valkey), hkeys(3valkey), hlen(3valkey), hmget(3valkey), hrandfield(3valkey), hscan(3valkey), hset(3valkey), hstrlen(3valkey), hvals(3valkey)