Increment numeric item's value

Memcached::getVersion
Memcached::prepend
Memcached
PHP Manual

# Memcached::increment

(PECL memcached >= 0.1.0)

Memcached::increment — Increment numeric item's value

### Description

public int Memcached::increment ( string `$key` [, int `$offset` = 1 ] )

Memcached::increment() increments a numeric item's value by the specified `offset`. If the item's value is not numeric, it is treated as if the value were 0. Memcached::increment() will fail if the item does not exist.

### Parameters

`key`

  The key of the item to increment.

`offset`

  The amount by which to increment the item's value.

### Return Values

Returns new item's value on success or `FALSE` on failure. The Memcached::getResultCode will return `Memcached::RES_NOTFOUND` if the key does not exist.

### Examples

Example #1 Memcached::increment() example

`<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
$m->set('counter', 0);
$m->increment('counter');
$m->increment('counter', 10);
var_dump($m->get('counter'));
$m->set('key', 'abc');
$m->increment('counter');
?>`

The above example will output:

    int(11)
    string(1) "1"

### See Also

- Memcached::decrement - Decrement numeric item's value

Memcached::getVersion
Memcached::prepend
Memcached
PHP Manual