Decrementa um número armazenado

# apcu_dec

(PECL apcu >= 4.0.0)

apcu_dec — Decrementa um número armazenado

### Descrição

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

Decrementa um valor inteiro armazenado.

### Parâmetros

`key`
  A chave do valor sendo decrementado.
`step`
  A quantidade, ou valor a decrementar.
`success`
  Opcionalmente, o valor booleano de sucesso ou falha é passado para esta variável de referência.
`ttl`
  TTL a ser usado se a operação inserir um novo valor (ao invés de decrementar um existente).

### Valor Retornado

Retorna o valor atual do valor da chave definida em `key` em caso de sucesso, ou `false` em caso de falha

### Exemplos

Exemplo #1 Exemplo de apcu_dec()

    <?php
    echo "Fazendo algo que funciona", PHP_EOL;

    apcu_store('numeral', 42);

    echo apcu_fetch('numeral'), PHP_EOL;

    echo apcu_dec('numeral'), PHP_EOL;
    echo apcu_dec('numeral', 10), PHP_EOL;
    echo apcu_dec('numeral', 10, $success), PHP_EOL;

    var_dump($success);

    echo "Agora, algo que falha", PHP_EOL, PHP_EOL;

    apcu_store('uma_string', 'foo');

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

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

O exemplo acima produzirá algo semelhante a:

    Fazendo algo que funciona
    42
    41
    31
    21
    bool(true)
    Agora, algo que falha

    bool(false)
    bool(false)

### Veja Também

- apcu_inc() - Incrementa um número armazenado

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