apcu_inc

Increase a stored number

&reftitle.description; ``int``false```apcu_inc` `string` `key` `int` `step` 1 `bool` `success` `int` `ttl` 0

Increases a stored number.

&reftitle.parameters;

`key`

- The key of the value being increased.

`step`

- The step, or value to increase.

`success`

- Optionally pass the success or fail boolean value to this referenced variable.

`ttl`

- TTL to use if the operation inserts a new value (rather than incrementing an existing one).

&reftitle.returnvalues;

Returns the current value of `key`'s value on success, &return.falseforfailure;

&reftitle.examples;

### `apcu_inc` example

    <?php
    echo "Let's do something with success", PHP_EOL;

    apcu_store('anumber', 42);

    echo apcu_fetch('anumber'), PHP_EOL;

    echo apcu_inc('anumber'), PHP_EOL;
    echo apcu_inc('anumber', 10), PHP_EOL;
    echo apcu_inc('anumber', 10, $success), PHP_EOL;

    var_dump($success);

    echo "Now, let's fail", PHP_EOL, PHP_EOL;

    apcu_store('astring', 'foo');

    $ret = apcu_inc('astring', 1, $fail);

    var_dump($ret);
    var_dump($fail);
    ?>

&example.outputs.similar;

    Let's do something with success
    42
    43
    53
    63
    bool(true)
    Now, let's fail

    bool(false)
    bool(false)

&reftitle.seealso;

- `apcu_dec`