Disminuye un valor numérico

# Memcached::decrement

(PECL memcached >= 0.1.0)

Memcached::decrement — Disminuye un valor numérico

### Descripción

public function 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open