Memcached::decrement

(PECL memcached >= 0.1.0)

Memcached::decrement — Disminuye un valor numérico

Descripción

public Memcached::decrement(
    string $key,
    int $offset = 1,
    int $initial_value = 0,
    int $expiry = 0
): int|false

Memcached::decrement() disminuye el valor numérico de offset unidades. Si el elemento no es numérico, se emitirá un error. Si la operación intenta disminuir por debajo de 0, el nuevo valor será 0. Memcached::decrement() establecerá el elemento al valor del parámetro initial_value si la clave no existe.

Parámetros

key: La clave del elemento a disminuir.
offset: La cantidad con la que disminuir el elemento.
initial_value: El valor a utilizar para definir el elemento si no existe.
expiry: El tiempo de expiración en la definición del elemento.

Valores devueltos

Devuelve el nuevo valor del elemento en caso de éxito o false si ocurre un error.

Ejemplos

Ejemplo #1 Ejemplo con Memcached::decrement()

<?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');
// ^ fallará debido a que el valor del elemento no es numérico
var_dump($n);
?>

El ejemplo anterior mostrará:

int(4)
int(0)
int(0)
bool(false)

Ver también

Memcached::increment() - Incrementa numéricamente un elemento
Memcached::incrementByKey() - Incrementa un valor numérico de un elemento almacenado en un servidor específico
Memcached::decrementByKey() - Disminuye un valor numérico de un elemento almacenado en un servidor específico