International PHP Conference Berlin 2025

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() - Увеличить сохранённое число
Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top