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 si ocurre un 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);
?>

Resultado del ejemplo anterior es 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() - Incrementa un número almacenado