DELEX

Syntax
DELEX key [IFEQ ifeq-value | IFNE ifne-value | IFDEQ ifdeq-digest |
  IFDNE ifdne-digest]
Available since:
Redis Open Source 8.4.0
Time complexity:
O(1) for IFEQ/IFNE, O(N) for IFDEQ/IFDNE where N is the length of the string value.
ACL categories:
@write, @string, @fast,

Conditionally removes the specified key based on value or hash digest comparison.

Hash Digest

A hash digest is a fixed-size numerical representation of a string value, computed using the XXH3 hash algorithm. Redis uses this hash digest for efficient comparison operations without needing to compare the full string content. You can retrieve a key's hash digest using the DIGEST command, which returns it as a hexadecimal string that you can use with the IFDEQ and IFDNE options, and also the SET command's IFDEQ and IFDNE options.

Options

The DELEX command supports a set of options that modify its behavior. Only one of the options can be specified.

  • IFEQ ifeq-value -- Remove the key if the value is equal to the specified value.
  • IFNE ifne-value -- Remove the key if the value is not equal to the specified value.
  • IFDEQ ifeq-digest -- Remove the key if its hash digest is equal to the specified hash digest.
  • IFDNE ifne-digest -- Remove the key if its hash digest is not equal to the specified hash digest.

In 8.4, keys must be of type string when using one of the options above. If no options are specified, the key is removed regardless of its type.

Redis Software and Redis Cloud compatibility

Redis
Enterprise		 Redis
Cloud		 Notes
❌ Standard
❌ Active-Active		 ❌ Standard
❌ Active-Active

Return information

One of the following:

  • Integer reply: 0 if not deleted (the key does not exist or a specified IFEQ/IFNE/IFDEQ/IFDNE condition is false), or 1 if deleted.
  • Simple error reply if the key exists but holds a value that is not a string and one of IFEQ, IFNE, IFDEQ, or IFDNE is specified.
RATE THIS PAGE
Back to top ↑