PHP-Handbuch: Create a new RegexIterator

Beschreibung

public RegexIterator::__construct ( Iterator $iterator , string $regex [, int $mode = self::MATCH [, int $flags = 0 [, int $preg_flags = 0 ]]] )

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

Parameter-Liste

iterator

The iterator to apply this regex filter to.

regex

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.

preg_flags

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.

Fehler/Exceptions

Throws an InvalidArgumentException if the regex argument is invalid.

Beispiele

Beispiel #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";
}
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

test 1
test 123

Siehe auch

preg_match
preg_match_all
preg_replace
preg_split