Redis 基础教程

Redis 命令

Redis 高级教程

Redis 笔记

original icon
版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.knowledgedict.com/tutorial/redis-command-renamenx.html

Redis RENAMENX 命令

Redis 键(Keys) Redis 键(Keys)


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