Memcached::decrementByKey

(PECL memcached >= 2.0.0)

Memcached::decrementByKey — Decrementa o valor do item numérico, armazenado em um servidor específico

Descrição

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

Memcached::decrementByKey() 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::decrementByKey() irá definir o item para o parâmetro initial_value se a key não existir.

Parâmetros

server_key

A chave que identifica o servidor no qual armazenar o valor ou de onde recuperá-lo. Em vez de fazer o hash na chave real do item, o hash é feito na chave do servidor ao decidir com qual servidor memcached se comunicar. Isso permite que itens relacionados sejam agrupados em um único servidor para eficiência com múltiplas operações.

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.

Veja Também