SETNX key value

可用版本： >= 1.0.0
时间复杂度： O(1)

只在键 key 不存在的情况下，将键 key 的值设置为 value 。

若键 key 已经存在，则 SETNX 命令不做任何动作。

SETNX 是『SET if Not eXists』(如果不存在，则 SET)的简写。

返回值

命令在设置成功时返回 1 ，设置失败时返回 0 。

代码示例

  1. redis> EXISTS job                # job 不存在
  2. (integer) 0
  3.  
  4. redis> SETNX job "programmer"    # job 设置成功
  5. (integer) 1
  6.  
  7. redis> SETNX job "code-farmer"   # 尝试覆盖 job ，失败
  8. (integer) 0
  9.  
  10. redis> GET job                   # 没有被覆盖
  11. "programmer"