Memcached::decrement

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

En esta página

Descripción#
Véase también#

Disminuye un valor numérico

Descripción#

public Memcached::decrement(string $key, [int $offset], [int $initial_value], [int $expiry]): int
```php

`Memcached::decrement` disminuye el valor numérico de `offset` unidades. Si el elemento no es numérico, se emitirá un error. Si la operación intenta disminuir por debajo de 0, el nuevo valor será 0. `Memcached::decrement` establecerá el elemento al valor del parámetro `initial_value` si la clave no existe.

## Parámetros

`key`  
La clave del elemento a disminuir.

`offset`  
La cantidad con la que disminuir el elemento.

`initial_value`  
El valor a utilizar para definir el elemento si no existe.

`expiry`  
El tiempo de expiración en la definición del elemento.

## Valores devueltos

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

## Ejemplos

Ejemplo con `Memcached::decrement`

addServer('localhost', 11211); $m->set('counter', 5); $n = $m->decrement('counter'); var_dump($n); $n = $m->decrement('counter', 10); var_dump($n); var_dump($m->get('counter')); $m->set('counter', 'abc'); $n = $m->increment('counter'); // ^ fallará debido a que el valor del elemento no es numérico var_dump($n); ?>

```php

El ejemplo anterior mostrará:

int(4)
int(0)
int(0)
bool(false)

Véase también#

Memcached::increment, Memcached::incrementByKey, Memcached::decrementByKey