str_ireplace

(PHP 5, PHP 7)

str_ireplace - str_replace（）的不区分大小写的版本。

描述

该函数返回一个字符串或一个数组，其中包含主题中所有出现的搜索（忽略大小写），并替换为给定的替换值。 如果您不需要更换规则，通常应该使用此函数而不是preg_replace（）和i修饰符。

参数

如果搜索和替换是数组，则str_ireplace（）从每个数组中获取一个值，并使用它们在主题上进行搜索和替换。 如果替换的值比搜索更少，那么替换值的其余部分将使用空字符串。 如果搜索是一个数组而replace是一个字符串，那么这个替换字符串用于每个搜索值。 尽管如此，反过来也是没有意义的。

如果search或者replace是数组，它们的元素会从最初处理到最后。

search

正在搜索的值，否则称为指针。一个数组可能被用来指定多个指针。

replace

替代值，替代找到的search值。一个数组可能被用来指定多个替换。

subject

正在搜索并替换的字符串或数组，也称为haystack 。

如果subject是一个数组，那么搜索和替换将在每个主题的条目中执行，并且返回值也是一个数组。

count

如果通过，这将被设置为执行的替换次数。

返回值

返回一个字符串或一个替换数组。

例子

示例＃1 str_ireplace（）示例

注意

注意：此功能是二进制安全的。

警告

因为str_ireplace（）从左向右替换，所以在执行多次替换时可能会替换先前插入的值。str_replace（）文档中的示例＃2演示了如何在实践中影响您。

扩展内容

• str_replace（） - 用替换字符串替换所有出现的搜索字符串

• preg_replace（） - 执行正则表达式搜索并替换

• strtr（） - 翻译字符或替换子字符串

← str_getcsv

str_pad →