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

str_ireplace · str_replace 的忽略大小写版本

· 52CE 我爱测

该函数返回字符串或者数组。该字符串或数组是将 subject 中全部的 search 都被 replace 替换(忽略大小写)之后的结果。

str_ireplace

(PHP 5, PHP 7, PHP 8)

str_ireplace — str_replace() 的忽略大小写版本

说明

function str_ireplace(
    array|string $search,
    array|string $replace,
    string|array $subject,
    int &$count = null
): string|array

该函数返回字符串或者数组。该字符串或数组是将 subject 中全部的 search 都被 replace 替换(忽略大小写)之后的结果。

要根据模式而不是固定字符串替换文本,将 preg_replace() 与 i 模式修饰符一起使用。

参数

如果 search 和 replace 为数组,那么 str_ireplace() 将对 subject 做二者的映射替换。如果 replace 的值的个数少于 search 的个数,多余的替换将使用空字符串来进行。如果 search 是一个数组而 replace 是一个字符串,那么 search 中每个元素的替换将始终使用这个字符串。

如果 search 或 replace 是数组,他们的元素将从头到尾一个个处理。

search

要搜索的值,就像是 needle。可以使用 array 来提供多个 needle。

replace

search 的替换值。一个数组可以被用来指定多重替换。

subject

要被搜索和替换的字符串或数组,就像是 haystack。

如果 subject 是一个数组,替换操作将遍历整个 subject,并且也将返回一个数组。

count

如果被指定,它的值将被设置为替换发生的次数。

返回值

返回替换后的字符串或者数组。

更新日志

版本 说明
8.2.0 大小写转换不在依赖于使用 setlocale() 设置的区域。只会进行 ASCII 大小写转换。非 ASCII 字节值将通过它们的字节值进行比较。

示例

示例 #1 str_ireplace() 示例

<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
echo $bodytag; // <body text=black>
?>

注释

注意:

此函数可安全用于二进制对象。

警告

替换顺序陷阱

因为 str_ireplace() 是从左到右替换,当进行多个替换时,可能会替换先前插入的值。str_replace() 文档中的示例 #2 展示了在实践中受到的影响。

参见

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

资料来源与适用范围

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

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

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