FilenameFilterIterator
extends MultiplePcreFilterIterator
in package
FilenameFilterIterator filters files by patterns (a regexp, a glob, or a string).
Tags
Table of Contents
Properties
- $matchRegexps : array<string|int, mixed>
- $noMatchRegexps : array<string|int, mixed>
Methods
- __construct() : mixed
- accept() : bool
- Filters the iterator values.
- isAccepted() : bool
- Checks whether the string is accepted by the regex filters.
- isRegex() : bool
- Checks whether the string is a regex.
- toRegex() : string
- Converts glob to regexp.
Properties
$matchRegexps
protected
array<string|int, mixed>
$matchRegexps
= []
$noMatchRegexps
protected
array<string|int, mixed>
$noMatchRegexps
= []
Methods
__construct()
public
__construct(Iterator<TKey, TValue> $iterator, array<string|int, string> $matchPatterns, array<string|int, string> $noMatchPatterns) : mixed
Parameters
- $iterator : Iterator<TKey, TValue>
-
The Iterator to filter
- $matchPatterns : array<string|int, string>
-
An array of patterns that need to match
- $noMatchPatterns : array<string|int, string>
-
An array of patterns that need to not match
accept()
Filters the iterator values.
public
accept() : bool
Return values
boolisAccepted()
Checks whether the string is accepted by the regex filters.
protected
isAccepted(string $string) : bool
If there is no regexps defined in the class, this method will accept the string. Such case can be handled by child classes before calling the method if they want to apply a different behavior.
Parameters
- $string : string
Return values
boolisRegex()
Checks whether the string is a regex.
protected
isRegex(string $str) : bool
Parameters
- $str : string
Return values
booltoRegex()
Converts glob to regexp.
protected
toRegex(string $str) : string
PCRE patterns are left unchanged. Glob strings are transformed with Glob::toRegex().
Parameters
- $str : string
-
Pattern: glob or regexp