apcu_dec

(PECL apcu >= 4.0.0)

apcu_dec — Уменьшить сохранённое число

Описание

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

Уменьшает сохранённое число.

Список параметров

key: Ключ значения, которое надо уменьшить.
step: Величина, на которую необходимо уменьшить.
success: Необязательный параметр. Если задан, то в него будет записано логическое значение true или false в зависимости от успешности операции уменьшения.
ttl: TTL(время жизни), используемое если операция вставляет новое значение (а не уменьшает существующее).

Возвращаемые значения

Возвращает текущее значение key в случае успешного выполнения или false, если возникла ошибка

Примеры

Пример #1 Пример использования apcu_dec()

<?php
echo "Сделаем что-то без ошибки", 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 "А теперь с ошибкой", PHP_EOL, PHP_EOL;

apcu_store('astring', 'foo');

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

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

Вывод приведённого примера будет похож на:

Сделаем что-то без ошибки
42
41
31
21
bool(true)
А теперь с ошибкой

bool(false)
bool(false)

Смотрите также

apcu_inc() - Увеличить сохранённое число