Memcached::incrementByKey

(PECL memcached >= 2.0.0)

Memcached::incrementByKey — Increment numeric item's value, stored on a specific server

Descrierea

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

Memcached::incrementByKey() increments a numeric item's value by the specified offset. If the item's value is not numeric, an error will result. Memcached::incrementByKey() 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 increment.
offset: The amount by which to increment 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 new item's value on success sau FALSE în cazul eșecului.

Vedeți de asemenea

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