RegexIterator::__construct
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
RegexIterator::__construct — Create a new RegexIterator
Beschreibung
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.
Parameter-Liste
-
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().
Fehler/Exceptions
Throws an InvalidArgumentException if the pattern
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() - Führt eine Suche mit einem regulären Ausdruck durch
- preg_match_all() - Führt eine vollständige Suche mit einem regulären Ausdruck durch
- preg_replace() - Sucht und ersetzt mit regulären Ausdrücken
- preg_split() - Zerlegt eine Zeichenkette anhand eines regulären Ausdrucks