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.

SETNX

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

SETNX stores value at key only when the key does not exist. It is the same as SET key value NX, but replies with an integer. To set a time to live in the same step, use SET with NX and EX instead.

Return value

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

Examples

Section titled “Examples”
127.0.0.1:6379> SETNX leader "node-a"
(integer) 1
127.0.0.1:6379> SETNX leader "node-b"
(integer) 0
127.0.0.1:6379> GET leader
"node-a"

Compatibility

Section titled “Compatibility”

Same as Redis 7 and Valkey 8.

See also

Section titled “See also”

SET, MSETNX, GETSET