# Memcached::decrementByKey

(PECL memcached >= 2.0.0)

Memcached::decrementByKey — Décrémente une valeur numérique d'un élément, stocké sur un serveur spécifique

### Description

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

Memcached::decrementByKey() décrémente une valeur numérique d'un élément en spécifiant l'incrément via le paramètre `offset`. Si la valeur de l'élément n'est pas un numérique, une erreur sera émise. Si l'opération décrémente la valeur en dessous de 0, la nouvelle valeur sera 0. Memcached::decrementByKey() va définir l'élément à la valeur du paramètre `initial_value` si la clé n'existe pas.

### Liste de paramètres

`server_key`

  La clé d'identification du serveur de stockage ou de récupération. Au lieu de hacher avec la clé courante pour l'élément, nous hachons avec la clé serveur lorsqu'il est décidé avec quel serveur memcache il convient de dialoguer. Ceci permet le regroupement des éléments correspondants sur un seul serveur permettant de meilleures performances lors d'opérations multiples.

`key`

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

`offset`

  L'incrément à utiliser sur la valeur de l'élément.

`initial_value`

  La valeur à définir si l'éménent n'existe pas.

`expiry`

  Le délai d'expiration pour 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.

### Voir aussi

- Memcached::decrement() - Décrémente une valeur numérique
- 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