大网数据广告活动
PHP 语言与运行手册

preg_replace_callback_array · 执行一个正则表达式搜索并使用回调进行替换

· 52CE 我爱测

preg_replace_callback_array — 执行一个正则表达式搜索并使用回调进行替换

preg_replace_callback_array

(PHP 7, PHP 8)

preg_replace_callback_array — 执行一个正则表达式搜索并使用回调进行替换

说明

function preg_replace_callback_array(
    array $pattern,
    string|array $subject,
    int $limit = -1,
    int &$count = null,
    int $flags = 0
): string|array|null

此函数的行为类似于 preg_replace_callback(),不同之处在于回调函数是基于每个模式分别执行的。

参数

pattern

一个关联数组,将模式(键)映射到 callable(值)。

subject

要搜索替换的目标字符串或字符串数组。

limit

对于每个模式用于每个 subject 字符串的最大可替换次数。 默认是 -1(无限制)。

count

如果指定,这个变量将被填充为替换执行的次数。

flags

flags 可以是 PREG_OFFSET_CAPTURE 和 PREG_UNMATCHED_AS_NULL 标志的组合,这会影响匹配到的结果的格式。 相关详情请参阅 preg_match() 中的描述。

返回值

如果 subject 是一个数组, preg_replace_callback_array() 返回一个数组,其他情况返回字符串。错误发生时返回 null。

如果查找到了匹配,返回替换后的目标字符串,其他情况 subject 将会无变化返回。

错误/异常

如果传递的正则表达式无法正常解析,会发出 E_WARNING。

更新日志

版本 说明
7.4.0 新增 flags 参数。

示例

示例 #1 preg_replace_callback_array() 示例

<?php
$subject = 'Aaaaaa Bbb';

preg_replace_callback_array(
    [
        '~[a]+~i' => function ($match) {
            echo strlen($match[0]), ' matches for "a" found', PHP_EOL;
        },
        '~[b]+~i' => function ($match) {
            echo strlen($match[0]), ' matches for "b" found', PHP_EOL;
        }
    ],
    $subject
);
?>

以上示例会输出:

6 matches for "a" found
3 matches for "b" found

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。