array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'regexiterator.construct.php', 1 => 'RegexIterator::__construct', 2 => 'Create a new RegexIterator', ), 'up' => array ( 0 => 'class.regexiterator.php', 1 => 'RegexIterator', ), 'prev' => array ( 0 => 'regexiterator.accept.php', 1 => 'RegexIterator::accept', ), 'next' => array ( 0 => 'regexiterator.getflags.php', 1 => 'RegexIterator::getFlags', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/spl/regexiterator/construct.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

RegexIterator::__construct

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

RegexIterator::__construct — Create a new RegexIterator

Description

public RegexIterator::__construct(
    Iterator $iterator,
    string $pattern,
    int $mode = RegexIterator::MATCH,
    int $flags = 0,
    int $pregFlags = 0
)

Create a new RegexIterator which filters an Iterator using a regular expression.

Parameters

iterator

The iterator to apply this regex filter to.

pattern

The regular expression to match.

mode

Operation mode, see RegexIterator::setMode() for a list of modes.

flags

Special flags, see RegexIterator::setFlags() for a list of available flags.

pregFlags

The regular expression flags. These flags depend on the operation mode parameter:

RegexIterator preg_flags
operation mode available flags
RegexIterator::ALL_MATCHES See preg_match_all().
RegexIterator::GET_MATCH See preg_match().
RegexIterator::MATCH See preg_match().
RegexIterator::REPLACE none.
RegexIterator::SPLIT See preg_split().

Errors/Exceptions

Throws an InvalidArgumentException if the pattern argument is invalid.

Examples

Example #1 RegexIterator::__construct() example

Creates a new RegexIterator that filters all strings that start with 'test'.

<?php
$arrayIterator = new ArrayIterator(array('test 1', 'another test', 'test 123'));
$regexIterator = new RegexIterator($arrayIterator, '/^test/');

foreach ($regexIterator as $value) {
echo $value . "\n";
}
?>

The above example will output something similar to:

test 1
test 123

See Also