# Memcached::decrement

(PECL memcached >= 0.1.0)

Memcached::decrement — Décrémente une valeur numérique

### Description

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

Memcached::decrement() décrémente la valeur numérique de `offset` unités. Si l'élément n'est pas numérique, une erreur sera émise. Si l'opération tente de décrémenter en dessous de 0, la nouvelle valeur sera 0. Memcached::decrement() va définir l'élément à la valeur du paramètre `initial_value` si la clé n'existe pas.

### Liste de paramètres

`key`

  La clé de l'élément à décrémenter.

`offset`

  La quantité avec laquelle diminuer l'élément.

`initial_value`

  La valeur à utiliser pour définir l'élément s'il n'existe pas.

`expiry`

  Le délai d'expiration dans la définition de l'élément.

### Valeurs de retour

Retourne la nouvelle valeur de l'élément en cas de succès ou `false` si une erreur survient.

### Exemples

Exemple #1 Exemple avec 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');
// ^ va échouer en raison du fait que la valeur de l'élément n'est pas un numérique
var_dump($n);
?>`

L'exemple ci-dessus va afficher :

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

### Voir aussi

- Memcached::increment() - Incrémente numériquement un élément
- Memcached::incrementByKey() - Incrémente une valeur numérique d'un élément, stocké sur un serveur spécifique
- Memcached::decrementByKey() - Décrémente une valeur numérique d'un élément, stocké sur un serveur spécifique