Memcached::decrementByKey
(PECL memcached >= 2.0.0)
Memcached::decrementByKey — Decrementa o valor do item numérico, armazenado em um servidor específico
Descrição
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
- Memcached::decrement() - Decrementa o valor do item numérico
- Memcached::increment() - Incrementa o valor do item numérico
- Memcached::incrementByKey() - Incrementa o valor do item numérico, armazenado em um servidor específico
add a note
