Decrementing Values in Memcached using Python (Detailed Guide w/ Code Examples)

Use Case(s)

The 'decr' function is used in memcached when you need to decrement a numeric value of a specific key. This is commonly used in scenarios like rate limiting, counters, and inventory management where you need to reduce the value by a certain amount.

Code Examples

To perform decrement operations, we will use pymemcache, which is a comprehensive, fast, pure-Python client library for interacting with memcached.

Firstly, install the pymemcache library if you haven't:

pip install pymemcache

The basic usage of decr operation is as follows:

from pymemcache.client import base client = base.Client(('localhost', 11211)) client.set('counter', 100) client.decr('counter', 10) print(client.get('counter')) # Output: 90

In this example, we first set a key 'counter' with a value of 100. Then we decrease it by 10 using the decr method. Finally, we retrieve the value which should now be 90.

Best Practices

  • Always ensure that the key exists before trying to decrement its value. If the key does not exist, the decr operation will return an error.
  • Make sure the value associated with the key is a number. If it's not a numeric value, you'll get an error since you can't decrement non-numeric values.

Common Mistakes

  • One common mistake is attempting to decrement the value below zero. In memcached, if a decrement operation would result in a negative number, the new value is 0.
  • Trying to decrement a key that doesn't exist or one that holds non-numeric data. Always ensure the key-value pair is valid for this operation.


Q: What happens if the value after decrement becomes negative? A: If a decrement operation would result in a negative number, memcached automatically resets the value to 0.

Q: What happens if I try to decrement a non-existing key? A: If you try to decrement a key that does not exist in memcached, an error will be returned.

Was this content helpful?

Start building today

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.