在线文档教程
PHP

preg_filter

preg_filter

(PHP 5 >= 5.3.0, PHP 7)

preg_filter - 执行正则表达式搜索并替换

描述

mixed preg_filter ( mixed $pattern , mixed $replacement , mixed $subject [, int $limit = -1 [, int &$count ]] )

preg_filter()与preg_replace()完全相同,除了它只返回匹配的(可能转换的)主体。有关此函数如何工作的详细信息,请阅读preg_replace()文档。

返回值

如果subject参数是一个数组,则返回一个数组,否则返回一个字符串。

如果未找到匹配项或发生错误,则当subject为数组时返回空数组,否则返回NULL。

例子

Example#1 比较preg_filter()和 preg_replace()的例子

<?php $subject = array('1', 'a', '2', 'b', '3', 'A', 'B', '4'  $pattern = array('/\d/', '/[a-z]/', '/[1a]/'  $replace = array('A:$0', 'B:$0', 'C:$0'  echo "preg_filter returns\n"; print_r(preg_filter($pattern, $replace, $subject)  echo "preg_replace returns\n"; print_r(preg_replace($pattern, $replace, $subject)  ?>

上面的例子将输出:

preg_filter returns Array ( [0] => A:C:1 [1] => B:C:a [2] => A:2 [3] => B:b [4] => A:3 [7] => A:4 ) preg_replace returns Array ( [0] => A:C:1 [1] => B:C:a [2] => A:2 [3] => B:b [4] => A:3 [5] => A [6] => B [7] => A:4 )

扩展内容

  • preg_quote() - 引用正则表达式字符

  • preg_replace() - 执行正则表达式搜索并替换

  • preg_replace_callback() - 执行正则表达式搜索并使用回调进行替换

  • preg_grep() - 返回与模式匹配的数组条目

  • preg_last_error() - 返回上一次PCRE正则表达式执行的错误代码

← PCRE Functions

preg_grep →