Memcached::incrementByKey

(PECL memcached >= 2.0.0)

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

Descrição

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.

Parâmetros

server_key: A chave identificando o servidor onde armazenar ou recuperar o valor. Em vez de fazer o hash do item, é feito o hash da chave do servidor quando decidindo com qual servidor memcached conectar. Isto permite que itens relacionados sejam agrupados em um único servidor para maior eficiência de operações múltiplas.
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.

Valor Retornado

Returns new item's value on success ou FALSE em caso de falha.

Veja Também

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