YAOHAIXIAO.COM

HTML(5),CSS(3),JavaScript,DOM,Ajax,JSON,Front-end technologies & Yaohaixiao

热门标签:JavaScript Performance 前端开发 前端性能优化 原创

Rss

Home » PHP » PHP preg_replace() 函数详解

PHP preg_replace() 函数详解

preg_replace() 函数是用来执行一个正则表达式的搜索和替换的。PHP 4.0 开始支持这个函数。

preg_replace 的语法

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

函数搜索 subject 中匹配 pattern 的部分, 以 replacement 进行替换。

preg_replace 的参数说明

参数 描述
pattern

要搜索的模式。可以使一个字符串或字符串数组。

可以使用一些PCRE修饰符,包括’e‘(PREG_REPLACE_EVAL),可以为这个函数指定。

replacement

用于替换的字符串或字符串数组。如果这个参数是一个字符串,并且pattern是一个数组,那么所有的模式都使用这个字符串进行替换。如果patternreplacement都是数组,每个pattern使用replacement中对应的元素进行替换。如果replacement中的元素比pattern中的少,多出来的pattern使用空字符串进行替换。

replacement中可以包含后向引用\\n或(php 4.0.4以上可用)$n,语法上首选后者。 每个这样的引用将被匹配到的第n个捕获子组捕获到的文本替换。 n可以是0-99,\\0$0代表完整的模式匹配文本。捕获子组的序号计数方式为:代表捕获子组的左括号从左到右, 从1开始数。如果要在replacement中使用反斜线,必须使用4个(“\\\\”,译注:因为这首先是php的字符串,经过转义后,是两个,再经过正则表达式引擎后才被认为是一个原文反斜线)。

当在替换模式下工作并且后向引用后面紧跟着需要是另外一个数字(比如:在一个匹配模式后紧接着增加一个原文数字),不能使用\\1这样的语法来描述后向引用。比如, \\11将会使 preg_replace()不能理解你希望的是一个\\1后向引用紧跟一个原文1,还是一个\\11后向引用后面不跟任何东西。 这种情况下解决方案是使用\${1}1。这创建了一个独立的$1后向引用, 一个独立的原文1

当使用e修饰符时, 这个函数会转义一些字符(即:\ 和 NULL) 然后进行后向引用替换。当这些完成后请确保后向引用解析完后没有单引号或双引号引起的语法错误(比如: ‘strlen(\’$1\’)+strlen(“$2″)’)。确保符合PHP字符串语法,并且符合eval语法。因为在完成替换后,引擎会将结果字符串作为php代码使用eval方式进行评估并将返回值作为最终参与替换的字符串。

subject

要进行搜索和替换的字符串或字符串数组。

如果subject是一个数组,搜索和替换回在subject
的每一个元素上进行, 并且返回值也会是一个数组。

limit

每个模式在每个subject上进行替换的最大次数。默认是
-1(无限)。

count

如果指定,将会被填充为完成的替换次数。

返回值

如果subject是一个数组, preg_replace()返回一个数组,其他情况下返回一个字符串。

如果匹配被查找到,替换后的subject被返回,其他情况下返回没有改变的 subject。如果发生错误,返回 NULL

更新日志

版本 说明
5.1.0 增加参数count.
4.0.4 增加replacement参数中的’$n’用法。
4.0.2 增加了参数limit

范例

Example #1 使用后向引用紧跟数值原文

<?php
$string 
'April 15, 2003';
$pattern '/(\w+) (\d+), (\d+)/i';
$replacement '${1}1,$3';
echo 
preg_replace($pattern$replacement$string);
?>

以上例程会输出:

April1,2003

Example #2 preg_replace()中使用基于索引的数组

<?php
$string 
'The quick brown fox jumped over the lazy dog.';
$patterns = array();
$patterns[0] = '/quick/';
$patterns[1] = '/brown/';
$patterns[2] = '/fox/';
$replacements = array();
$replacements[2] = 'bear';
$replacements[1] = 'black';
$replacements[0] = 'slow';
echo 
preg_replace($patterns$replacements$string);
?>

以上例程会输出:

The bear black slow jumped over the lazy dog.

对模式和替换内容按key进行排序我们可以得到期望的结果。

<?php
ksort
($patterns);
ksort($replacements);
echo 
preg_replace($patterns$replacements$string);
?>

以上例程会输出:

The slow black bear jumped over the lazy dog.

Example #3 替换一些值

<?php
$patterns 
= array ('/(19|20)(\d{2})-(\d{1,2})-(\d{1,2})/',
                   
'/^\s*{(\w+)}\s*=/');
$replace = array ('\3/\4/\1\2''$\1 =');
echo 
preg_replace($patterns$replace'{startDate} = 1999-5-27');
?>

以上例程会输出:

$startDate = 5/27/1999

Example #4 使用修饰符’e’

<?php
preg_replace
("/(<\/?)(\w+)([^>]*>)/e"
             
"'\\1'.strtoupper('\\2').'\\3'"
             
$html_body);
?>

这可以捕获输入文本中所有的 HTML 标签

Example #5 剥离空白字符

这个例子剥离多余的空白字符

<?php
$str 
'foo   o';
$str preg_replace('/\s\s+/'' '$str);
// 将会改变为'foo o'
echo $str;
?>

Example #6 使用参数count

<?php
$count 
0;

echo 
preg_replace(array('/\d/''/\s/'), '*''xp 4 to', -$count);
echo 
$count//3
?>

以上例程会输出:

xp***to
3

注释

Note:
当使用数组形式的patternreplacement时, 将会按照key在数组中出现的顺序进行处理. 这不一定和数组的索引顺序一致.如果你期望使用索引对等方式用replacementpattern进行替换, 你可以在调用 preg_replace()之前对两个数组各进行一次 ksort()排序.

参考文档

说明:以上关于 preg_replace() 函数的 API 说明文档摘录自 PHP.NETpreg_replace 文档。

声明:本文采用BY-NC-SA协议进行授权。转载请注明转自:PHP preg_replace() 函数详解

« »

发表评论

电子邮件地址不会被公开。 必填项已用*标注

您可以使用这些HTML标签和属性: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>

(Spamcheck Enabled)