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

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

Historial de cambios

Versión Descripción
5.1.12 El parámetro ttl fué añadido.

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