APCUIterator::__construct

Constructs an APCUIterator iterator object

&reftitle.description; public `APCUIterator::__construct` ``array``string``null```search`&null; `int` `format` APC_ITER_ALL `int` `chunk_size` 100 `int` `list` APC_LIST_ACTIVE

Constructs an `APCUIterator` `object`.

&reftitle.parameters;

`search`

- Either a PCRE regular expression that matches against APCu key names, given as a &string;. Or an &array; of &string;s with APCu key names. Or, optionally &null; to skip the search.

`format`

- The desired format, as configured with one or more of the APC_ITER_* constants.

`chunk_size`

- The chunk size. Must be a value greater than 0. The default value is 100.

`list`

- The type to list. Either pass in `APC_LIST_ACTIVE` or `APC_LIST_DELETED`.

&reftitle.examples;

### A `APCUIterator::__construct` example

    <?php
    foreach (new APCUIterator('/^counter\./') as $counter) {
        echo "$counter[key]: $counter[value]\n";
        apc_dec($counter['key'], $counter['value']);
    }
    ?>

&reftitle.seealso;

- `apcu_exists`
- `apcu_cache_info`