Увеличивает числовое значение записи

# Memcached::increment

(PECL memcached >= 0.1.0)

Memcached::increment — Увеличивает числовое значение записи

### Описание

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

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

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

`key`

  Ключ увеличиваемой записи.

`offset`

  Величина на которую происходит увеличение значения записи.

`initial_value`

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

`expiry`

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

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

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

### Примеры

Пример #1 Пример использования Memcached::increment()

    <?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');
    // Завершится неудачей т.к. значение записи не является числовым
    var_dump($n);
    ?>

Результат выполнения приведённого примера:

    int(11)
    bool(false)

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

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

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