Memcached::decrement

(PECL memcached >= 0.1.0)

Memcached::decrement — Decrementa o valor do item numérico

Descrição

public Memcached::decrement(
    string $key,
    int $offset = 1,
    int $initial_value = 0,
    int $expiry = 0
): int|false

Memcached::decrement() diminui o valor de um item numérico pelo offset especificado. Se o valor do item não for numérico, ocorrerá um erro. Se a operação diminuir o valor abaixo de 0, o novo valor será 0. Memcached::decrement() irá definir o item para o parâmetro initial_value se a key não existir.

Parâmetros

key

A key do item a ser decrementado.

offset

A quantia pela qual decrementar o valor do item.

initial_value

O valor para definir o item se ele não existir no momento.

expiry

O tempo de expiração a ser definido no item.

Valor Retornado

Retorna o novo valor do item em caso de sucesso ou ou false em caso de falha.

Exemplos

Example #1 Memcached::decrement() exemplo

<?php
$m = new Memcached();
$m->addServer('localhost', 11211);

$m->set('counter', 5);
$n = $m->decrement('counter');
var_dump($n);

$n = $m->decrement('counter', 10);
var_dump($n);

var_dump($m->get('counter'));

$m->set('counter', 'abc');
$n = $m->increment('counter');
// ^ falhará devido ao valor do item não ser numérico
var_dump($n);
?>

O exemplo acima produzirá:

int(4)
int(0)
int(0)
bool(false)

Veja Também