Memcached::decrement
Decrement numeric item's value
Description
public intfalse Memcached::decrement(
string $key
,
int $offset
= 1,
int $initial_value
= 0,
int $expiry
= 0
)
Parameters
-
key
-
The key of the item to decrement.
-
offset
-
The amount by which to decrement the item's value.
-
initial_value
-
The value to set the item to if it doesn't currently exist.
-
expiry
-
The expiry time to set on the item.
Return Values
Returns item's new value on success or false
on failure.
Examples
Example #1 Memcached::decrement example
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
$m->set('counter', 5);
$n = $m->decrement('counter');
var_dump($n);
$n = $m->decrement('counter', 10);
var_dump($n);
var_dump($m->get('counter'));
$m->set('counter', 'abc');
$n = $m->increment('counter');
// ^ will fail due to item value not being numeric
var_dump($n);
?>
The above example will output:
int(4)
int(0)
int(0)
bool(false)
See Also
- Memcached::increment
- Memcached::incrementByKey
- Memcached::decrementByKey