Memcached::increment

(PECL memcached >= 0.1.0)

Memcached::incrementIncrementa numéricamente un elemento

Descripción

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

Memcached::increment() incrementa el valor numérico de offset unidades. Si el elemento no es numérico, se generará un error. Memcached::increment() establecerá el elemento al valor del argumento initial_value si la clave no existe.

Parámetros

key

La clave del elemento a incrementar.

offset

La cantidad con la que aumentar el elemento.

initial_value

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

expiry

El tiempo de expiración para definir el elemento.

Valores devueltos

Devuelve el nuevo valor del elemento, en caso de éxito o false en caso de error.

Ejemplos

Ejemplo #1 Ejemplo con Memcached::getResultCode()

<?php
$m
= new Memcached();
$m->addServer('localhost', 11211);

$m->set('counter', 0);
$m->increment('counter');
$n = $m->increment('counter', 10);
var_dump($n);

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

El resultado del ejemplo sería:

int(11)
bool(false)

Ver también