哈希空间 Ctrl + F 进行搜索
首页 php手册中文版 CSS中文手册 哈希文档 Markdown在线工具

PHP str 组件

str_ireplace

(PHP 5, PHP 7, PHP 8)

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

说明

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

该函数返回一个字符串或者数组。该字符串或数组是将 subject 中全部的 search 都被 replace 替换(忽略大小写)之后的结果。如果没有一些特殊的替换规则,你应该使用该函数替换带有 i 修正符的 preg_replace() 函数。

参数

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

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

search

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

replace

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

subject

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

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

count

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

返回值

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

范例

示例 #1 str_ireplace() 范例

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

注释

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

警告

替换顺序陷阱

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

参见

打开 哈希空间 微信小程序中查看更佳