RENAMENX命令表示当且仅当newkey不存在时,将key改名为newkey。
命令格式
RENAMENX key newkey
可用版本:>=1.0.0
时间复杂度:O(1)
命令参数
- key:要变更的源key名称。
- newkey:要变更的目标key名称。
命令返回值
RENAMENX命令返回有2种情况:
- 返回1,如果成功将key改名为newkey。
- 返回0,如果newkey已经存在。
此外,如果指定的key不存在时,RENAMENX命令会返回一个错误。
在3.2.0版本之前,key和newkey名称相同时,Redis会返回一个错误。
示例
redis> RENAMENX mystring newmystring # 指定key不存在,返回一个错误
(error) ERR no such key
redis> SET mystring hello
OK
redis> SET newmystring_exist world
OK
redis> RENAMENX mystring newmystring_exist # newkey已经存在,返回0
(integer) 0
redis> RENAMENX mystring newmystring # newkey不存在,改名成功,返回1
(integer) 1