Memcached::decrementByKey

(PECL memcached >= 2.0.0)

Memcached::decrementByKey — Disminuye un valor numérico de un elemento almacenado en un servidor específico

Descripción

public Memcached::decrementByKey(
    string $server_key,
    string $key,
    int $offset = 1,
    int $initial_value = 0,
    int $expiry = 0
): int|false

Memcached::decrementByKey() disminuye un valor numérico de un elemento especificando el decremento mediante el argumento offset. Si el valor del elemento no es numérico, se generará un error. Si la operación disminuye el valor por debajo de 0, el nuevo valor será 0. Memcached::decrementByKey() establecerá el elemento al valor del argumento initial_value si la clave no existe.

Parámetros

server_key: La clave que identifica el servidor donde almacenar o recuperar el valor. En lugar de calcular el hash sobre la clave real del elemento, se calcula el hash sobre la clave del servidor al decidir con qué servidor memcached comunicarse. Esto permite agrupar elementos relacionados en un solo servidor para mayor eficiencia con operaciones múltiples.
key: La clave del elemento a disminuir.
offset: El decremento a aplicar al valor del elemento.
initial_value: El valor a establecer si el elemento no existe.
expiry: El tiempo de expiración para la definición del elemento.

Valores devueltos

Devuelve el nuevo valor del elemento en caso de éxito o false si ocurre un error.

Ver también

Memcached::decrement() - Disminuye un valor numérico
Memcached::increment() - Incrementa numéricamente un elemento
Memcached::incrementByKey() - Incrementa un valor numérico de un elemento almacenado en un servidor específico