Уменьшает числовое значение записи, хранящееся на определённом сервере

# Memcached::decrementByKey

(PECL memcached >= 2.0.0)

Memcached::decrementByKey — Уменьшает числовое значение записи, хранящееся на определённом сервере

### Описание

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

Memcached::decrementByKey() уменьшает числовое значение записи на величину заданную в `offset`. Если значение записи не является числовым, то будет возвращена ошибка. Если функция уменьшит значение записи меньше нуля, будет установлено нулевое значение. Memcached::decrementByKey() установит записи значение параметра `initial_value` если переданного ключа не существует.

### Список параметров

`server_key`

  Ключ, который идентифицирует сервер, на котором хранится значение. Вместо хеширования фактического ключа элемента хешируется ключ сервера, когда решается, с каким сервером memcached взаимодействовать. Это разрешает группировать связанные элементы вместе на одном сервере, что повышает эффективность групповых операций.

`key`

  Ключ уменьшаемой записи.

`offset`

  Величина на которую уменьшается значение записи.

`initial_value`

  Инициирующее значение, устанавливаемое записи, если ключа не существует.

`expiry`

  Время, когда срок действия записи истекает.

### Возвращаемые значения

Возвращает новое значение записи в случае успешного выполнения или `false`, если возникла ошибка.

### Смотрите также

- Memcached::decrement() - Уменьшает числовое значение записи
- Memcached::increment() - Увеличивает числовое значение записи
- Memcached::incrementByKey() - Увеличивает числовое значение записи, хранимой на указанном сервере

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open