Memcache::decrement

Manuel PHP
Précédent		Suivant

Description

int Memcache::decrement ( string key [, int value] )

Memcache::decrement() décrémente la valeur de l'élément par value. De la même façon que la fonction memcache::increment(), la valeur courante de l'élément est tout d'abord convertie en numérique et seulement ensuite, on soustrait la valeur value.

Le paramètre value est optionnel. Par défaut, il vaut 1.

Note : La nouvelle valeur de l'élément ne peut être inférieure à zéro.

Note : N'utilisez pas la fonction Memcache::decrement() avec les éléments stockés compressés. Dans ce cas, l'appel à la fonction Memcache::get() échouera.

Vous pouvez également utiliser la fonction memcache_decrement(). Regardez l'exemple ci-dessous.

Exemple 1. Exemple avec Memcache::decrement()


<?php

/* API proécédurale */
$memcache_obj = memcache_connect('memcache_host', 11211);
/* decrement item by 2 */
$new_value = memcache_decrement($memcache_obj, 'test_item', 2);

/* API orientée objet */
$memcache_obj = new Memcache;
$memcache_obj->connect('memcache_host', 11211);
/* décrémentation de l'élément par 3 */
$new_value = $memcache_obj->decrement('test_item', 3);
?>

Memcache::decrement() ne crée pas l'élément s'il n'existe pas.

Memcache::decrement() retourne la nouvelle valeur de l'élément en cas de succès ou FALSE en cas d'échec.

Voir aussi Memcache::increment() et Memcache::replace().

Précédent	Sommaire	Suivant
memcache_debug	Niveau supérieur	Memcache::delete