RegexIterator::setMode

(PHP 5 >= 5.2.0, PHP 7)

Sets the operation mode.

public void RegexIterator::setMode ( int $mode )

Sets the operation mode.

Parameters:

mode

The operation mode.

The available modes are listed below. The actual meanings of these modes are described in the predefined constants.

**RegexIterator modes**
value	constant
0	RegexIterator::MATCH
1	RegexIterator::GET_MATCH
2	RegexIterator::ALL_MATCHES
3	RegexIterator::SPLIT
4	RegexIterator::REPLACE

Returns:

No value is returned.

Examples:

RegexIterator::setMode() example

<?php
$test = array ('str1' => 'test 1', 'test str2' => 'another test', 'str3' => 'test 123');
 
$arrayIterator = new ArrayIterator($test);
// Filter everything that starts with 'test ' followed by one or more numbers.
$regexIterator = new RegexIterator($arrayIterator, '/^test (\d+)/');
// Operation mode: Replace actual value with the matches
$regexIterator->setMode(RegexIterator::GET_MATCH);
 
foreach ($regexIterator as $key => $value) {
    // print out the matched number(s)
    echo $key . ' => ' . $value[1] . PHP_EOL;
}
?>

The above example will output something similar to:

str1 => 1
str3 => 123