# apcu_dec

(PECL apcu >= 4.0.0)

apcu_dec — Disminuir un número almacenado

### Descripción

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` en caso de error

### Ejemplos

Ejemplo #1 Ejemplo de apcu_dec()

`<?php
echo "Let's do something with success", 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 "Now, let's fail", PHP_EOL, PHP_EOL;
apcu_store('astring', 'foo');
$ret = apcu_dec('astring', 1, $fail);
var_dump($ret);
var_dump($fail);
?>`

El resultado del ejemplo sería algo similar a:

    Let's do something with success
    42
    41
    31
    21
    bool(true)
    Now, let's fail

    bool(false)
    bool(false)

### Ver también

- apcu_inc() - Increase a stored number