目录

PHP preg_replace() 函数

❮ PHP 正则表达式参考

示例

使用不区分大小写的正则表达式将字符串中的 Microsoft 替换为 91xjr:

<?php
$str = 'Visit Microsoft!';
$pattern = '/microsoft/i';
echo preg_replace($pattern, '91xjr', $str);
?>
亲自试一试 »

定义和用法

这个preg_replace()函数返回一个字符串或字符串数​​组,其中输入中找到的模式或模式列表的所有匹配项都将替换为子字符串。

可以通过三种不同的方式使用此功能:

1. 一个模式和一个替换字符串。模式的匹配项将替换为替换字符串。

2. 模式数组和替换字符串。匹配任何模式都将替换为替换字符串。

3. 一组模式和一组替换字符串。每个模式的匹配项都将替换为替换数组中相同位置处的替换字符串。如果在该位置没有找到任何项目,则匹配项将替换为空字符串。

替换字符串可以包含 \n 或 $n 形式的反向引用,其中 n 是模式中组的索引。在返回的字符串中,\n 和 $n 的实例将替换为与该组匹配的子字符串,或者如果使用 \0 或 $0,则替换为整个表达式。

笔记:对于每个输入字符串,该函数按照给定的顺序评估模式。评估字符串上第一个模式的结果用作第二个模式的输入字符串,依此类推。这可能会导致意外的行为。


语法

preg_replace( patterns, replacements, input, limit, count)

参数值

Parameter Description
patterns Required. Contains a regular expression or array of regular expressions
replacements Required. A replacement string or an array of replacement strings
input Required. The string or array of strings in which replacements are being performed
limit Optional. Defaults to -1, meaning unlimited. Sets a limit to how many replacements can be done in each string
count Optional. After the function has executed, this variable will contain a number indicating how many replacements were performed

技术细节

返回值: 返回对输入字符串或多个字符串应用替换后得到的字符串或字符串数​​组
PHP 版本: 4.0.5+
变更日志: PHP 5.1.0 - 添加了 count 参数

❮ PHP 正则表达式参考