
功能块PREG_REPLACE使用正则表达式进行搜索和替换。
注意:此函数是二进制安全的。这意味着UTF8字符不能直接处理。
要搜索的表达式作为字符串。也可以使用一些PCRE修饰符。
用于替换的字符串。此字符串可以包含形式为\n或$n的引用,后者更可取。这些引用中的每一个都会被第n个括号内捕获的搜索模式匹配的文本替换。n可以是从0到99的值。\0或$0指的是与完整搜索模式匹配的文本。要获取捕获子搜索模式的编号,从左到右计算开放括号,从1开始。在替换中使用反斜杠需要将其加倍"\\"。
如果您想要处理一个替换,其中回退引用后面直接跟着另一个数字(即,在与搜索模式匹配后应该有一个数字),则不能使用\1的写法来表示您的回退引用。例如,\11会使函数感到困惑,因为它不知道您是想要\1后面跟着数字1,还是仅仅\11。在这种情况下,解决方案是使用${1}1。这样会生成一个孤立的回退引用$1,而1保持为字母符号。
如果您使用了过时的修饰符e,此函数会对用于替换回退引用的字符串中的一些字符(即'、"、\和NULL)进行掩码。这样做是为了确保在使用包含单引号或双引号的回退引用时不会出现语法错误。请确保您了解字符串语法,以便准确知道求值后的字符串是什么样子。
该输入定义了要搜索的字符串。
每个subject中每个搜索模式的最大可能替换次数。默认值:-1或NULL(无限制)。
如果找到匹配项,则返回新字符串Q;否则,将返回未更改的SUBJECT或NULL,如果发生错误。
该输出返回执行的替换次数。