PHP preg_replace() 函数
示例
使用不区分大小写的正则表达式将字符串中的 Microsoft 替换为 W3Schools
<?php
$str = 'Visit Microsoft!';
$pattern = '/microsoft/i';
echo preg_replace($pattern, 'W3Schools', $str);
?>
自己动手试一试 »
定义和用法
preg_replace()
函数返回一个字符串或一组字符串,其中输入字符串中找到的所有匹配的模式或模式列表都被替换为子字符串。
该函数有三种不同的用法:
1. 一个模式和一个替换字符串。匹配的模式将被替换为替换字符串。
2. 一个模式数组和一个替换字符串。匹配的任何模式都将被替换为替换字符串。
3. 一个模式数组和一个替换字符串数组。每个模式的匹配都将被替换为替换数组中相同位置的替换字符串。如果该位置没有找到项目,则匹配将被替换为空字符串。
替换字符串可能包含反向引用,形式为 \n 或 $n,其中 n 是模式中某个组的索引。在返回的字符串中,\n 和 $n 的实例将被匹配的组的子字符串替换,或者,如果使用 \0 或 $0,则会被整个表达式替换。
注意:对于每个输入字符串,函数按给定顺序评估模式。第二个模式将使用第一个模式字符串的评估结果作为输入字符串,以此类推。这可能会导致意外行为。
语法
preg_replace(patterns, replacements, input, limit, count)
参数值
参数 | 描述 |
---|---|
patterns | 必需。包含正则表达式或正则表达式数组 |
replacements | 必需。替换字符串或替换字符串数组 |
input | 必需。执行替换的字符串或字符串数组 |
limit | 可选。默认为 -1,表示不限制。设置在每个字符串中可以执行的替换次数 |
count | 可选。函数执行后,此变量将包含一个数字,指示执行了多少次替换 |
技术详情
返回值 | 返回通过将替换应用于输入字符串或字符串而生成的字符串或字符串数组 |
---|---|
PHP 版本 | 4.0.5+ |
更新日志 | PHP 5.1.0 - 添加了 count 参数 |
❮ PHP 正则表达式参考