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

# 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 function 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 chave 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 chave 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

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