PHP preg_replace_callback PCRE正则函数



  • 定义和用法

    preg_replace_callback - 执行一个正则表达式搜索并且使用一个回调进行替换
  • 版本支持

    PHP4 PHP5 PHP7
    支持 支持 支持
    5.1.0 增加了参数count。
  • 语法

    preg_replace_callback ( mixed $pattern , callable $callback , mixed $subject [, int $limit = -1 [, int &$count ]] )
    
    这个函数的行为除了 可以指定一个 callback 替代 replacement 进行替换 字符串的计算,其他方面等同于 preg_replace()
  • 参数

    参数 必需的 描述
    pattern 要搜索的模式,可以是字符串或一个字符串数组。
    callback 一个回调函数,在每次需要替换时调用,调用时函数得到的参数是从subject 中匹配到的结果。回调函数返回真正参与替换的字符串。这是该回调函数的签名:handler ( array $matches )。你可能经常会需要callback函数而 仅用于preg_replace_callback()一个地方的调用。在这种情况下,你可以 使用匿名函数来定义一个匿名函数作 为preg_replace_callback()调用时的回调。 这样做你可以保留所有 调用信息在同一个位置并且不会因为一个不在任何其他地方使用的回调函数名称而污染函数名称空间。
    subject 要搜索替换的目标字符串或字符串数组。
    limit 每个主题字符串中每个模式的最大可能替换数。 默认为-1(无限制)。
    count 如果指定,此变量将填充完成的替换次数。
  • 返回值

    如果subject是一个数组, preg_replace_callback()返回一个数组,其他情况返回字符串。 错误发生时返回 NULL。 如果查找到了匹配,返回替换后的目标字符串(或字符串数组), 其他情况subject 将会无变化返回。
  • 示例

    // 将文本中的年份增加一年.
    $text = "April fools day is 04/01/2002\n";
    $text.= "Last christmas was 12/24/2001\n";
    // 回调函数
    function next_year($matches)
    {
      // 通常: $matches[0]是完成的匹配
      // $matches[1]是第一个捕获子组的匹配
      // 以此类推
      return $matches[1].($matches[2]+1);
    }
    echo preg_replace_callback(
                "|(\d{2}/\d{2}/)(\d{4})|",
                "next_year",
                $text);
    
  • 相关函数

    preg_replace_callback() - 执行一个正则表达式搜索并且使用一个回调进行替换
    preg_quote() - 转义正则表达式字符
    preg_replace() - 执行一个正则表达式的搜索和替换
    preg_last_error() - 返回最后一个PCRE正则执行产生的错误代码
    preg_replace_callback_array() - 执行正则表达式搜索并使用回调替换