Incrementa o valor do item numérico

# Memcached::increment

(PECL memcached >= 0.1.0)

Memcached::increment — Incrementa o valor do item numérico

### Descrição

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

Memcached::increment() incrementa o valor de um item numérico pelo `offset` especificado. Se o valor do item não for numérico, ocorrerá um erro. Memcached::increment() irá definir o item para o parâmetro `initial_value` se a chave não existir.

### Parâmetros

`key`

  A chave do item a incrementar.

`offset`

  A quantia pela qual incrementar o valor do item.

`initial_value`

  O valor para definir o item se ele não existir no momento.

`expiry`

  O tempo de expiração a ser definido no item.

### Valor Retornado

Retorna o valor do novo item em caso de sucesso ou `false` em caso de falha.

### Exemplos

Exemplo #1 Exemplo de 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');
    // ^ falhará devido ao valor do item não ser numérico
    var_dump($n);
    ?>

O exemplo acima produzirá:

    int(11)
    bool(false)

### Veja Também

- Memcached::decrement() - Decrementa o valor do item numérico
- Memcached::decrementByKey() - Decrementa o valor do item numérico, armazenado em um servidor específico
- Memcached::incrementByKey() - Incrementa o valor do item numérico, armazenado em um servidor específico

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