str_ireplace

(PHP 5, PHP 7, PHP 8)

str_ireplacestr_replace() 的忽略大小寫版本

說明

str_ireplace(
    mixed $search,
    mixed $replace,
    mixed $subject,
    int &$count = ?
): mixed

該函數(shù)返回一個字符串或者數(shù)組。該字符串或數(shù)組是將 subject 中全部的 search 都被 replace 替換(忽略大小寫)之后的結(jié)果。如果沒有一些特殊的替換規(guī)則,你應(yīng)該使用該函數(shù)替換帶有 i 修正符的 preg_replace() 函數(shù)。

參數(shù)

如果 searchreplace 為數(shù)組,那么 str_ireplace() 將對 subject 做二者的映射替換。如果 replace 的值的個數(shù)少于 search 的個數(shù),多余的替換將使用空字符串來進行。如果 search 是一個數(shù)組而 replace 是一個字符串,那么 search 中每個元素的替換將始終使用這個字符串。

如果 searchreplace 是數(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ù)可安全用于二進制對象。

警告

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.

參見