該函數(shù)返回一個字符串或者數(shù)組。該字符串或數(shù)組是將 subject
中全部的 search
都被 replace
替換(忽略大小寫)之后的結(jié)果。如果沒有一些特殊的替換規(guī)則,你應(yīng)該使用該函數(shù)替換帶有 i
修正符的 preg_replace() 函數(shù)。
如果 search
和 replace
為數(shù)組,那么 str_ireplace() 將對 subject
做二者的映射替換。如果 replace
的值的個數(shù)少于 search
的個數(shù),多余的替換將使用空字符串來進行。如果 search
是一個數(shù)組而 replace
是一個字符串,那么 search
中每個元素的替換將始終使用這個字符串。
如果 search
或 replace
是數(shù)組,他們的元素將從頭到尾一個個處理。
search
要搜索的值,就像是 needle??梢允褂?array 來提供多個 needle。
replace
search
的替換值。一個數(shù)組可以被用來指定多重替換。
subject
要被搜索和替換的字符串或數(shù)組,就像是 haystack。
如果 subject
是一個數(shù)組,替換操作將遍歷整個 subject
,并且也將返回一個數(shù)組。
count
如果被指定,它的值將被設(shè)置為替換發(fā)生的次數(shù)。
返回替換后的字符串或者數(shù)組。
示例 #1 str_ireplace() 范例
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
echo $bodytag; // <body text=black>
?>
注意: 此函數(shù)可安全用于二進制對象。
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.