Memcache::increment

(no version information, might be only in CVS)

Memcache::increment -- Incrément la valeur d'un élément

Description

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

Memcache::increment() incrémente la valeur d'un élément identifié par la clé key par la valeur value. Si l'élément identifié par la clé key n'est pas de type numérique et ne peut être converti en nombre, la valeur de cette élément sera défini à value.

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

Note : N'utilisez pas memcache::increment() 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_increment(). Regardez l'exemple ci-dessous.

Exemple 1. Exemple avec Memcache::increment()

<?php

/* API procédurale */
$memcache_obj = memcache_connect('memcache_host', 11211);
/* incrémentation du compteur de 2 */
$current_value = memcache_increment($memcache_obj, 'counter', 2);

/* API orientée objet */
$memcache_obj = new Memcache;
$memcache_obj->connect('memcache_host', 11211);
/* incrémentation du compteur de 3 */
$current_value = $memcache_obj->increment('counter', 3);

?>

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

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

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