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
Redis OBJECT 命令允许从内部查看指定 key 的 Redis 对象信息。它通常用在调试,或者了解相关 key 是否使用特殊编码的 ...
SORT命令返回或保存指定列表、集合、有序集合key中经过排序的元素。 ...
Redis GET 命令返回指定 key 所关联的字符串值。如果指定的 key 不存在时,返回特殊值 nil。此外,如果指定的 key 存储 ...
TYPE 命令返回指定 key 所储存的值的类型。 ...
Redis COMMAND 命令用于返回所有的 Redis 命令的详细信息,并以数组形式展示。 ...