The RegexIterator class

Introduction

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

This iterator can be used to filter another iterator based on a regular expression.

class RegexIterator extends FilterIterator {

/* Constants */

const int MATCH = 0;

const int GET_MATCH = 1;

const int ALL_MATCHES = 2;

const int SPLIT = 3;

const int REPLACE = 4;

const int USE_KEY = 1;

/* Properties */

public ? string $replacement = null;

/* Methods */

public __construct(
Iterator $iterator,
string $pattern,
int $mode = RegexIterator::MATCH,
int $flags = 0,
int $pregFlags = 0
)

public accept(): bool

public getFlags(): int

public getMode(): int

public getPregFlags(): int

public getRegex(): string

public setFlags(int $flags): void

public setMode(int $mode): void

public setPregFlags(int $pregFlags): void

/* Inherited methods */

public FilterIterator::accept(): bool

public FilterIterator::current(): mixed

public FilterIterator::getInnerIterator(): Iterator

public FilterIterator::key(): mixed

public FilterIterator::next(): void

public FilterIterator::rewind(): void

public FilterIterator::valid(): bool

public IteratorIterator::current(): mixed

public IteratorIterator::getInnerIterator(): ?Iterator

public IteratorIterator::key(): mixed

public IteratorIterator::next(): void

public IteratorIterator::rewind(): void

public IteratorIterator::valid(): bool

}

RegexIterator::ALL_MATCHES: Return all matches for the current entry (see preg_match_all()).
RegexIterator::GET_MATCH: Return the first match for the current entry (see preg_match()).
RegexIterator::MATCH: Only execute match (filter) for the current entry (see preg_match()).
RegexIterator::REPLACE: Replace the current entry (see preg_replace(); Not fully implemented yet)
RegexIterator::SPLIT: Returns the split values for the current entry (see preg_split()).

RegexIterator::USE_KEY: Special flag: Match the entry key instead of the entry value.

© 1997–2021 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/class.regexiterator.php