Memcached::decrementByKey
(PECL memcached >= 2.0.0)
Memcached::decrementByKey — Decrement numeric item's value, stored on a specific server
Descrierea
$server_key
, string $key
, int $offset = 1
, int $initial_value = 0
, int $expiry = 0
) : int|false
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
add a note
