str_ireplace

(PHP 5, PHP 7)

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

mixed str_ireplace ( mixed $search , mixed $replace , mixed $subject [, int &$count ] )

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

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

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

search

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

replace

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

subject

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

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

count

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

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

示例＃1 str_ireplace（）示例

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

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

警告

更换-顺序-gotcha

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

← str_getcsv

str_pad →