PHP str_ireplace() 函數

實例

把字符串 "Hello world!" 中的字符 "WORLD"(不區分大小寫)替換成 "Shanghai":

<?php
echo str_ireplace("WORLD","Shanghai","Hello world!");
?>

運行實例

定義和用法

str_ireplace() 函數替換字符串中的一些字符(不區分大小寫)。

該函數必須遵循下列規則:

  • 如果搜索的字符串是一個數組,那么它將返回一個數組。
  • 如果搜索的字符串是一個數組,那么它將對數組中的每個元素進行查找和替換。
  • 如果同時需要對數組進行查找和替換,并且需要執行替換的元素少于查找到的元素的數量,那么多余元素將用空字符串進行替換
  • 如果是對一個數組進行查找,但只對一個字符串進行替換,那么替代字符串將對所有查找到的值起作用。

注釋:該函數不區分大小寫。請使用 str_replace() 函數來執行區分大小寫的搜索。

注釋:該函數是二進制安全的。

語法

str_ireplace(find,replace,string,count)
參數 描述
find 必需。規定要查找的值。
replace 必需。規定替換 find 中的值的值。
string 必需。規定被搜索的字符串。
count 可選。一個變量,對替換數進行計數。

技術細節

返回值: 返回帶有替換值的字符串或數組。
PHP 版本: 5+
更新日志: 在 PHP 5.0 中,新增了 count 參數。

更多實例

例子 1

使用帶有數組和 count 變量的 str_ireplace() 函數:

<?php
$arr = array("blue","red","green","yellow");
print_r(str_ireplace("RED","pink",$arr,$i)); // 此函數對大小寫不敏感
echo "替換數:$i";
?>

運行實例

例子 2

使用帶有需要替換的元素少于查找到的元素的 str_ireplace() 函數:

<?php
$find = array("HELLO","WORLD");
$replace = array("B");
$arr = array("Hello","world","!");
print_r(str_ireplace($find,$replace,$arr));
?>

運行實例