Memcached::decrement
(PECL memcached >= 0.1.0)
Memcached::decrement — Décrémente une valeur numérique
Description
$key
[, int $offset
= 1
[, int $initial_value
= 0
[, int $expiry
= 0
]]] )
Memcached::decrement() décrémente la valeur numérique
de offset
unités. Si l'élément n'est pas numérique,
une erreur sera émise. Si l'opération tente de décrémenter en dessous de 0,
la nouvelle valeur sera 0. Memcached::decrement()
va définir l'élément à la valeur du paramètre initial_value
si la clé n'existe pas.
Liste de paramètres
-
key
-
La clé de l'élément à décrémenter.
-
offset
-
La quantité avec laquelle diminuer l'élément.
-
initial_value
-
La valeur à utiliser pour définir l'élément s'il n'existe pas.
-
expiry
-
Le délai d'expiration dans la définition de l'élément.
Valeurs de retour
Retourne la nouvelle valeur de l'élément en cas de succès ou FALSE
si une erreur survient.
Exemples
Exemple #1 Exemple avec Memcached::append()
<?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'); // ^ va échouer en raison du fait que la valeur de l'élément n'est pas un numérique var_dump($n); ?>
L'exemple ci-dessus va afficher :
int(4) int(0) int(0) bool(false)
Voir aussi
- Memcached::increment() - Incrémente numériquement un élément
- Memcached::incrementByKey() - Incrémente une valeur numérique d'un élément, stocké sur un serveur spécifique
- Memcached::decrementByKey() - Décrémente une valeur numérique d'un élément, stocké sur un serveur spécifique