# str_ireplace

(PHP 5, PHP 7)

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

### 说明

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

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

### 参数

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

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

`search`

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

`replace`

  The replacement value that replaces found `search` values. An array may be used to designate multiple replacements.

`subject`

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

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

`count`

  如果设定了，将会设置执行替换的次数。

### 返回值

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

### 范例

Example #1 str_ireplace() 范例

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

### 注释

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

Caution

# Replacement order gotcha

Because str_ireplace() replaces left to right, it might replace a previously inserted value when doing multiple replacements. Example #2 in the str_replace() documentation demonstrates how this may affect you in practice.

### 参见

- str_replace() - 子字符串替换
- preg_replace() - 执行一个正则表达式的搜索和替换
- strtr() - 转换指定字符