PHP str_replace() 函數

實例

把字串"Hello world!" 中的字元"world" 替換成"Peter"：

<?phpecho str_replace("world","Peter","Hello world!");?>

定義和用法

str_replace() 函數取代字串中的一些字元（區分大小寫）。

此函數必須遵循下列規則：

如果搜尋的字串是一個數組，那麼它將傳回一個數組。

如果搜尋的字串是一個數組，那麼它將對數組中的每個元素進行查找和替換。

如果同時需要對某個數組進行查找和替換，並且需要執行替換的元素少於查找到的元素的數量，那麼多餘的元素將用空字串進行替換。

如果是對一個陣列進行查找，但只對一個字串進行替換，那麼替代字串將對所有查找到的值起作用。

註釋：該函數是區分大小寫的。請使用str_ireplace() 函數執行不區分大小寫的搜尋。

註：該函數是二進制安全的。

文法

str_replace( find,replace,string,count )

參數	描述
find	必需。規定要找的值。
replace	必需。規定替換find中的值的值。
string	必需。規定被搜尋的字串。
count	可選。一個變量，對替換數進行計數。

技術細節

傳回值：	傳回帶有替換值的字串或陣列。
PHP 版本：	4+
更新日誌：	在PHP 5.0 中，新增了count參數。在PHP 4.3.3 之前，該函數的find和replace參數都為數組時將會遇到麻煩，會造成空的find索引在內部指標沒有更換到replace數組上時被忽略。新的版本不會有這個問題。自PHP 4.0.5 起，大多數參數可以是一個陣列。

更多實例

實例1

使用具有陣列和count 變數的str_replace() 函數：

<?php$arr = array("blue","re​​d","green","yellow");print_r(str_replace("red","pink",$arr,$i));echo "Replacements: $ i";?>

實例2

使用帶有需要替換的元素少於查找到的元素的str_replace() 函數：

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