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