PHP 8.5.0 Alpha 2 available for testing

Memcached::decrement

(PECL memcached >= 0.1.0)

Memcached::decrementDisminuye un valor numérico

Descripción

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

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 #1 Ejemplo con Memcached::decrement()

<?php
$m
= new Memcached();
$m->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);
?>

El ejemplo anterior mostrará :

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

Ver también

add a note

User Contributed Notes 3 notes

up
17
Pramod Patil
10 years ago
decrement will not change TTL of the stored key/value.
up
11
Pramod Patil
10 years ago
Found possible bug :
decrement fails and returns -1 when memcached::OPT_BINARY_PROTOCOL is set to true.

tested on PECL Memcached 2.1.0 and libmemcached version 1.0.8
up
0
jbaginski
12 years ago
PECL memcached < 0.2.0

public int Memcached::decrement ( string $key [, int $offset = 1 ] )
To Top