RENAMENX key newkey

Renames key to newkey if newkey does not yet exist. It returns an error when key does not exist.

Note: Before Redis 3.2.0, an error is returned if source and destination names are the same.

*Return value

Integer reply, specifically:

  • 1 if key was renamed to newkey.
  • 0 if newkey already exists.

*Examples

redis>  SET mykey "Hello"
OK
redis>  SET myotherkey "World"
OK
redis>  RENAMENX mykey myotherkey
(integer) 0
redis>  GET myotherkey
"World"
redis>