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

# apcu_dec

(PECL apcu >= 4.0.0)

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

### Описание

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open