Decrement numeric item's value, stored on a specific server

# Memcached::decrementByKey

(PECL memcached >= 2.0.0)

Memcached::decrementByKey — Decrement numeric item's value, stored on a specific server

### Descrierea

public Memcached::decrementByKey ( string `$server_key` , string `$key` [, int `$offset` = 1 [, int `$initial_value` = 0 [, int `$expiry` = 0 ]]] ) : int

Memcached::decrementByKey() decrements a numeric item's value by the specified `offset`. If the item's value is not numeric, an error will result. If the operation would decrease the value below 0, the new value will be 0. Memcached::decrementByKey() will set the item to the `initial_value` parameter if the key doesn't exist.

### Parametri

`server_key`

  Cheia ce identifică serverul pe care se înscrie, sau de pe care se citește valoarea. În loc de a efectua hash asupra cheii nemijlocite a elementului, se efectuaează hash asupra cheii serverului, atunci când se decide cu care server memcached să se comunice. Aceasta permite ca elementele asociate să fie grupate împreună pe un singur server pentru a mări eficiența operațiilor multiple.

`key`

  The key of the item to decrement.

`offset`

  The amount by which to decrement the item's value.

`initial_value`

  The value to set the item to if it doesn't currently exist.

`expiry`

  The expiry time to set on the item.

### Valorile întoarse

Returns item's new value on success sau `FALSE` în cazul eșecului.

### A se vedea și

- Memcached::decrement() - Decrement numeric item's value
- Memcached::increment() - Increment numeric item's value
- Memcached::incrementByKey() - Increment numeric item's value, stored on a specific server