(PHP 5)
str_ireplace — str_replace() 的忽略大小寫版本
說明
mixed str_ireplace ( mixed$search
, mixed $replace
, mixed $subject
[, int &$count
] )
該函數返回一個字符串或者數組。該字符串或數組是將 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
如果設定了,將會設置執行替換的次數。
返回值
返回替換后的字符串或者數組。
更新日志
版本
說明
5.0.0
新增 count
參數。
范例
Example #1 str_ireplace() 范例
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
?>
注釋
Note: 此函數可安全用于二進制對象。
Caution Replacement order gotchaBecause 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() - 轉換指定字符