Memcached::decrement

(PECL memcached >= 0.1.0)

Memcached::decrement — Decrementar de forma numérica el valor de un ítem

Descripción

public int Memcached::decrement ( string $key [, int $offset = 1 ] )

Memcached::decrement() decrementa el valor númerico del ítem por el offset especificado. Si el valor del ítem no es numérico, es tratado como si su valor fuera 0. Si la operación requiere decrementar un valor inferior a 0, el nuevo valor será 0. Memcached::decrement() fallará si el ítem no existe.

Parámetros

key: La clave del ítem a decrementar.
offset: La cantidad que se quiere decrementar el valor del ítem.

Valores devueltos

Devuelve el nuevo valor del ítem en caso de éxito o FALSE en caso de error. The Memcached::getResultCode() Devolverá Memcached::RES_NOTFOUND si la clave no existe.

Ejemplos

Ejemplo #1 Ejemplo de Memcached::decrement()


<?php
$m = new Memcached();
$m->addServer('localhost', 11211);

$m->set('counter', 5);
$m->decrement('counter');
var_dump($m->get('counter'));

$m->decrement('counter', 10);
var_dump($m->get('counter'));
?>

El resultado del ejemplo sería:

int(4)
int(0)

Ver también

Memcached::increment() - Incrementa el valor númerico del ítem