RegexIterator::accept
RegexIterator::getFlags
RegexIterator
PHP Manual

# RegexIterator::__construct

(PHP 5 >= 5.2.0)

RegexIterator::__construct — Create a new RegexIterator

### 説明

RegexIterator::__construct ( Iterator `$iterator` , string `$regex` [, int `$mode` [, int `$flags` [, int `$preg_flags` ]]] )

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

### 例

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

上の例の出力は、 たとえば以下のようになります。

    test 1
    test 123

### 参考

- preg_match() - 正規表現によるマッチングを行う
- preg_match_all() - 繰り返し正規表現検索を行う
- preg_replace() - 正規表現検索および置換を行う
- preg_split() - 正規表現で文字列を分割する

RegexIterator::accept
RegexIterator::getFlags
RegexIterator
PHP Manual