apcu_dec

(PECL apcu >= 4.0.0)

apcu_dec — Decrementa um número armazenado

Descrição

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

Example #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