RecursiveRegexIterator

class RecursiveRegexIterator extends RegexIterator implements RecursiveIterator (View source)

This recursive iterator can filter another recursive iterator via a regular expression.

Constants

ALL_MATCHES

Return all matches for the current entry preg_match_all
GET_MATCH

Return the first match for the current entry preg_match
MATCH

Only execute match (filter) for the current entry preg_match
REPLACE

Replace the current entry (Not fully implemented yet) preg_replace
SPLIT

Returns the split values for the current entry preg_split
USE_KEY

Special flag: Match the entry key instead of the entry value.
INVERT_MATCH

Properties

$replacement from  RegexIterator

Methods

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

Creates a new RecursiveRegexIterator.

Iterator|null
getInnerIterator()

Get the inner iterator

from  FilterIterator
void
rewind()

Rewind the iterator

from  FilterIterator
bool
valid()

Check whether the current element is valid

from  FilterIterator
mixed
key()

Get the current key

from  FilterIterator
mixed
current()

Get the current element value

from  FilterIterator
void
next()

Move the iterator forward

from  FilterIterator
bool
accept()

Get accept status

from  RegexIterator
int
getMode()

Returns operation mode.

from  RegexIterator
void
setMode(int $mode)

Sets the operation mode.

from  RegexIterator
int
getFlags()

Get flags

from  RegexIterator
void
setFlags(int $flags)

Sets the flags.

from  RegexIterator
string
getRegex()

Returns current regular expression

from  RegexIterator
int
getPregFlags()

Returns the regular expression flags.

from  RegexIterator
void
setPregFlags(int $pregFlags)

Sets the regular expression flags.

from  RegexIterator
bool
hasChildren()

Returns whether an iterator can be obtained for the current entry.

RecursiveIterator|null
getChildren()

Returns an iterator for the current entry.

Details

at line 1336
__construct(Traversable $iterator, string $pattern, int $mode = RegexIterator::MATCH, int $flags = 0, int $pregFlags = 0)

Creates a new RecursiveRegexIterator.

Parameters

Traversable $iterator
string $pattern

The regular expression to match.
int $mode

[optional] Operation mode, see RegexIterator::setMode() for a list of modes.
int $flags

[optional] Special flags, see RegexIterator::setFlags() for a list of available flags.
int $pregFlags

[optional] The regular expression flags. These flags depend on the operation mode parameter

in FilterIterator at line 566
Iterator|null getInnerIterator()

Get the inner iterator

Return Value

Iterator|null

The inner iterator for the current entry.

in FilterIterator at line 529
void rewind()

Rewind the iterator

Return Value

void

Any returned value is ignored.

in FilterIterator at line 537
bool valid()

Check whether the current element is valid

Return Value

bool

The return value will be casted to boolean and then evaluated. Returns true on success or false on failure.

in FilterIterator at line 544
mixed key()

Get the current key

Return Value

mixed

TKey on success, or null on failure.

in FilterIterator at line 551
mixed current()

Get the current element value

Return Value

mixed

Can return any type.

in FilterIterator at line 558
void next()

Move the iterator forward

Return Value

void

Any returned value is ignored.

in RegexIterator at line 1190
bool accept()

Get accept status

Return Value

bool

true if the current element is acceptable, otherwise false.

in RegexIterator at line 1198
int getMode()

Returns operation mode.

Return Value

int

the operation mode.

in RegexIterator at line 1251
void setMode(int $mode)

Sets the operation mode.

Parameters

int $mode

The operation mode.

The available modes are listed below. The actual meanings of these modes are described in the predefined constants.

RegexIterator modes
value constant
0 RegexIterator::MATCH
1 RegexIterator::GET_MATCH
2 RegexIterator::ALL_MATCHES
3 RegexIterator::SPLIT
4 RegexIterator::REPLACE

Return Value

void

in RegexIterator at line 1259
int getFlags()

Get flags

Return Value

int

the set flags.

in RegexIterator at line 1288
void setFlags(int $flags)

Sets the flags.

Parameters

int $flags

The flags to set, a bitmask of class constants.

The available flags are listed below. The actual meanings of these flags are described in the predefined constants.

RegexIterator flags
value constant
1 RegexIterator::USE_KEY

Return Value

void

in RegexIterator at line 1297
string getRegex()

Since: 5.4

Returns current regular expression

Return Value

string

in RegexIterator at line 1305
int getPregFlags()

Returns the regular expression flags.

Return Value

int

a bitmask of the regular expression flags.

in RegexIterator at line 1317
void setPregFlags(int $pregFlags)

Sets the regular expression flags.

Parameters

int $pregFlags

The regular expression flags. See RegexIterator::__construct for an overview of available flags.

Return Value

void

at line 1349
bool hasChildren()

Returns whether an iterator can be obtained for the current entry.

Return Value

bool

true if the current entry can be iterated over, otherwise returns false.

at line 1357
RecursiveIterator|null getChildren()

Returns an iterator for the current entry.

Return Value

RecursiveIterator|null

An iterator for the current entry.