RENAMENX key newkey

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

当且仅当 newkey 不存在时,将 key 改名为 newkey

key 不存在时,返回一个错误。

返回值

修改成功时,返回 1 ;如果 newkey 已经存在,返回 0

代码示例

  1. # newkey 不存在,改名成功
  2.  
  3. redis> SET player "MPlyaer"
  4. OK
  5.  
  6. redis> EXISTS best_player
  7. (integer) 0
  8.  
  9. redis> RENAMENX player best_player
  10. (integer) 1
  11.  
  12.  
  13. # newkey存在时,失败
  14.  
  15. redis> SET animal "bear"
  16. OK
  17.  
  18. redis> SET favorite_animal "butterfly"
  19. OK
  20.  
  21. redis> RENAMENX animal favorite_animal
  22. (integer) 0
  23.  
  24. redis> get animal
  25. "bear"
  26.  
  27. redis> get favorite_animal
  28. "butterfly"