CF.DEL

Deletes an item once from the filter.

If the item exists only once, it will be removed from the filter. If the item was added multiple times, it will still be present.

{{< note >}} Never use this command to delete an item unless you are certain you've added the item to the filter. Deleting an item you didn't previously add may corrupt the filter and cause false negatives. {{< /note >}}

Required arguments

<details open><summary><code>key</code></summary>

is key name for a cuckoo filter.

</details> <details open><summary><code>item</code></summary>

is an item to delete.

</details>

Complexity

O(n), where n is the number of sub-filters. Both alternative locations are checked on all sub-filters.

Examples

{{< highlight bash >}} redis> CF.INSERT cf ITEMS item1 item2 item2

1. (integer) 1
2. (integer) 1
3. (integer) 1 redis> CF.DEL cf item1 (integer) 1 redis> CF.DEL cf item1 (integer) 0 redis> CF.DEL cf item2 (integer) 1 redis> CF.DEL cf item2 (integer) 1 redis> CF.DEL cf item2 (integer) 0 {{< / highlight >}}

Redis Software and Redis Cloud compatibility

| Redis Software | Redis Cloud | <span style="min-width: 9em; display: table-cell">Notes</span> | |:----------------------|:-----------------|:------| | <span title="Supported">✅ Supported</span> | <span title="Supported">✅ Flexible & Annual</span> <span title="Supported">✅ Free & Fixed</nobr></span> | |

Return information

{{< multitabs id="cf-del-return-info" tab1="RESP2" tab2="RESP3" >}}

One of the following:

• [Integer reply]({{< relref "/develop/reference/protocol-spec#integers" >}}) 1 for successfully deleting an item, or 0 if no such item was found in the filter.
• [Simple error reply]({{< relref "/develop/reference/protocol-spec#simple-errors" >}}) in these cases: invalid arguments or wrong key type.

-tab-sep-

One of the following:

• [Boolean reply]({{< relref "/develop/reference/protocol-spec#booleans" >}}) true for successfully deleting an item, or false if no such item was found in the filter.
• [Simple error reply]({{< relref "/develop/reference/protocol-spec#simple-errors" >}}) in these cases: invalid arguments or wrong key type.

{{< /multitabs >}}