array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.apcu-inc.php', 1 => 'apcu_inc', 2 => 'Incrementa um número armazenado', ), 'up' => array ( 0 => 'ref.apcu.php', 1 => 'APCu Funções', ), 'prev' => array ( 0 => 'function.apcu-fetch.php', 1 => 'apcu_fetch', ), 'next' => array ( 0 => 'function.apcu-key-info.php', 1 => 'apcu_key_info', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/apcu/functions/apcu-inc.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

apcu_inc

(PECL apcu >= 4.0.0)

apcu_inc — Incrementa um número armazenado

Descrição

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

Incrementa um número armazenado.

Parâmetros

key
A chave do valor sendo incrementado.
step
A quantidade, ou o valor a incrementar.
success
Opcionalmente o valor booleano de sucesso ou falha é armazenado nesta variável passada por referência.
ttl
TTL a ser usado se a operação inserir um novo valor (ao invés de incrementar um existente).

Valor Retornado

Retorna o valor atual do valor da chave definida em key em caso de sucesso, ou false em caso de falha

Exemplos

Exemplo #1 Exemplo de apcu_inc()

<?php
echo "Fazendo algo que funciona", PHP_EOL;

apcu_store('numeral', 42);

echo apcu_fetch('numeral'), PHP_EOL;

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

var_dump($success);

echo "Agora, algo que falha", PHP_EOL, PHP_EOL;

apcu_store('uma_string', 'foo');

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

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

O exemplo acima produzirá algo semelhante a:

Fazendo algo que funciona
42
43
53
63
bool(true)
Agora, algo que falha

bool(false)
bool(false)

Veja Também