(PHP 5 >= 5.2.0, PHP 7, PHP 8)
RegexIterator::__construct — Crée un nouvel objet RegexIterator
$iterator,$pattern,$mode = RegexIterator::MATCH,$flags = 0,$pregFlags = 0Crée un nouvel objet RegexIterator qui filtre un itérateur Iterator en utilisant une expression rationnelle.
iteratorL'itérateur sur lequel l'expression rationnelle sera appliquée.
patternL'expression rationnelle.
modeLe mode de l'opération, voir la méthode RegexIterator::setMode() pour une liste des modes.
flagsDrapeaux spéciaux, voir la méthode RegexIterator::setFlags() pour une liste des drapeaux disponibles.
pregFlagsLes drapeaux de l'expression rationnelle. Ils dépendant du mode de l'opération :
| Mode de l'opération | Drapeaux disponibles |
|---|---|
| RegexIterator::ALL_MATCHES | Voir la fonction preg_match_all(). |
| RegexIterator::GET_MATCH | Voir la fonction preg_match(). |
| RegexIterator::MATCH | Voir la fonction preg_match(). |
| RegexIterator::REPLACE | Aucun. |
| RegexIterator::SPLIT | Voir la fonction preg_split(). |
Lance une exception InvalidArgumentException
si l'argument pattern est invalide.
Exemple #1 Exemple avec RegexIterator::__construct()
Crée un nouvel objet RegexIterator qui filtre toutes les chaînes commençant par 'test'.
<?php
$arrayIterator = new ArrayIterator(array('test 1', 'another test', 'test 123'));
$regexIterator = new RegexIterator($arrayIterator, '/^test/');
foreach ($regexIterator as $value) {
echo $value . "\n";
}
?>Résultat de l'exemple ci-dessus est similaire à :
test 1 test 123