(PHP 5 >= 5.2.0, PHP 7)
RegexIterator::__construct — Crée un nouvel objet RegexIterator
$iterator
, string $regex
[, int $mode = self::MATCH
[, int $flags = 0
[, int $preg_flags = 0
]]] )Cré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.
regexL'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.
preg_flagsLes 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 regex 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";
}
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
test 1 test 123