PHP str_replace() 函数

实例

把字符串 "Hello world!" 中的字符 "world" 替换为 "Shanghai":

  1. <!DOCTYPE html>
  2. <html>
  3. <body>
  4. <?php
  5. echo str_replace("world","Shanghai","Hello world!");
  6. ?>
  7. </body>
  8. </html>

定义和用法

str_replace() 函数以其他字符替换字符串中的一些字符(区分大小写)。

该函数必须遵循下列规则:

  • 如果搜索的字符串是数组,那么它将返回数组。
  • 如果搜索的字符串是数组,那么它将对数组中的每个元素进行查找和替换。
  • 如果同时需要对数组进行查找和替换,并且需要执行替换的元素少于查找到的元素的数量,那么多余元素将用空字符串进行替换
  • 如果查找的是数组,而替换的是字符串,那么替代字符串将对所有查找到的值起作用。

注释:该函数区分大小写。请使用 str_ireplace() 函数执行不区分大小写的搜索。

注释:该函数是二进制安全的。


语法

  1. str_replace(find,replace,string,count)
参数描述
find必需。规定要查找的值。
replace必需。规定替换 find 中的值的值。
string必需。规定被搜索的字符串。
count可选。对替换数进行计数的变量。

技术细节

返回值:返回带有替换值的字符串或数组。
PHP 版本:4+
更新日志:

在 PHP 5.0 中,新增了 count 参数。

在 PHP 4.3.3 之前,该函数的 findreplace 参数都为数组时将会遇到麻烦,会引起空的 find 索引在内部指针没有更换到 replace 数组上时被忽略。新的版本不会有这个问题。

自 PHP 4.0.5 起,大多数参数可以是一个数组。


更多实例

例子 1

使用带有数组和 count 变量的 str_replace() 函数:

  1. <!DOCTYPE html>
  2. <html>
  3. <body>
  4. <?php
  5. $arr = array("blue","red","green","yellow");
  6. print_r(str_replace("red","pink",$arr,$i));
  7. echo "替换数:$i";
  8. ?>
  9. </body>
  10. </html>
例子 2

使用带有需要替换的元素少于查找到的元素的 str_replace() 函数:

  1. <!DOCTYPE html>
  2. <html>
  3. <body>
  4. <?php
  5. $find = array("Hello","world");
  6. $replace = array("B");
  7. $arr = array("Hello","world","!");
  8. print_r(str_replace($find,$replace,$arr));
  9. ?>
  10. </body>
  11. </html>

分类导航