RegexIterator::__construct()

(PHP 5 >= 5.2.0, PHP 7)

Create a new RegexIterator

说明

Create a new RegexIterator which filters an Iterator using a regular expression.

参数

$iterator

The iterator to apply this regex filter to.

$regex

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.

$preg_flags

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

错误／异常

Throws an InvalidArgumentException if the $regex argument is invalid.

范例

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

以上例程的输出类似于：

test 1
test 123

参见

• preg_match()执行匹配正则表达式
• preg_match_all()执行一个全局正则表达式匹配
• preg_replace()执行一个正则表达式的搜索和替换
• preg_split()通过一个正则表达式分隔字符串