RegexIterator::__construct

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

RegexIterator::__construct — Create a new RegexIterator

Descrizione

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.

Elenco dei parametri

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().

Errori/Eccezioni

Throws an InvalidArgumentException if the pattern argument is invalid.

Esempi

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

Il precedente esempio visualizzerà qualcosa simile a:

test 1
test 123

Vedere anche:

preg_match() - Riconoscimento con espressioni regolari
preg_match_all() - Esegue un riconoscimento globale con le espressioni regolari
preg_replace() - Esegue una ricerca ed una sostituzione con le espressioni regolari
preg_split() - Suddivisione di una stringa tramite le espressioni regolari

add a note

User Contributed Notes

There are no user contributed notes for this page.