# apcu_dec

(PECL apcu >= 4.0.0)

apcu_dec — Decrease a stored number

### Beschreibung

apcu_dec(
string `$key`,
int `$step` = 1,
bool `&$success` = ?,
int `$ttl` = 0
): int|false

Decreases a stored integer value.

### Parameter-Liste

`key`
  The key of the value being decreased.
`step`
  The step, or value to decrease.
`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 decrementing an existing one).

### Rückgabewerte

Returns the current value of `key`'s value on success, Bei einem Fehler wird `false` zurückgegeben.

### Beispiele

Beispiel #1 apcu_dec() example

`<?php
echo "Let's do something with success", PHP_EOL;
apcu_store('anumber', 42);
echo apcu_fetch('anumber'), PHP_EOL;
echo apcu_dec('anumber'), PHP_EOL;
echo apcu_dec('anumber', 10), PHP_EOL;
echo apcu_dec('anumber', 10, $success), PHP_EOL;
var_dump($success);
echo "Now, let's fail", PHP_EOL, PHP_EOL;
apcu_store('astring', 'foo');
$ret = apcu_dec('astring', 1, $fail);
var_dump($ret);
var_dump($fail);
?>`

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

    Let's do something with success
    42
    41
    31
    21
    bool(true)
    Now, let's fail

    bool(false)
    bool(false)

### Siehe auch

- apcu_inc() - Increase a stored number

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