Documentación offline PHP master

Memcached::decrementByKey

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Memcached::decrementByKey

Disminuye un valor numérico de un elemento almacenado en un servidor específico

Descripción#

php public Memcached::decrementByKey(string $server_key, string $key, [int $offset], [int $initial_value], [int $expiry]): intphp

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.

Véase también#

Memcached::decrement, Memcached::increment, Memcached::incrementByKey