Disminuir un número almacenado

# apcu_dec

(PECL apcu >= 4.0.0)

apcu_dec — Disminuir un número almacenado

### Descripción

function apcu_dec(
string `$key`,
int `$step` = 1,
bool `&$success` = ?,
int `$ttl` = 0
): int|false

Disminuye un valor entero almacenado.

### Parámetros

`key`
  La clave de el valor a ser disminuido.
`step`
  El paso, o valor a disminuir.
`success`
  Opcionalmente pasa el valor booleano en caso de éxito o en caso de error a esta variable referenciada.
`ttl`
  TTL para usar si la operación inserta un nuevo valor (en lugar de disminuir uno existente).

### Valores devueltos

Devuelve el valor actual del valor de las claves (`key`) en caso de éxito, o `false` si ocurre un error

### Ejemplos

Ejemplo #1 Ejemplo de apcu_dec()

    <?php
    echo "Hagamos algo con éxito", PHP_EOL;

    apcu_store('anumber', 42);

    echo apcu_fetch('anumber'), PHP_EOL;

    echo apcu_dec('anumber'), PHP_EOL;
    echo apcu_dec('anumber', 10), PHP_EOL;
    echo apcu_dec('anumber', 10, $success), PHP_EOL;

    var_dump($success);

    echo "Ahora, hagamos que falle", PHP_EOL, PHP_EOL;

    apcu_store('astring', 'foo');

    $ret = apcu_dec('astring', 1, $fail);

    var_dump($ret);
    var_dump($fail);
    ?>

Resultado del ejemplo anterior es similar a:

    Hagamos algo con éxito
    42
    41
    31
    21
    bool(true)
    Ahora, hagamos que falle

    bool(false)
    bool(false)

### Ver también

- apcu_inc() - Incrementa un número almacenado

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