PHP str_replace() 函数
PHP str_replace() 函数替换字符串中的一些字符(区分大小写)
( PHP >= 4 )
函数原型
str_replace( find,replace,string,count)
该函数必须遵循下列规则:
- 如果搜索的字符串是一个数组,那么它将返回一个数组
- 如果搜索的字符串是一个数组,那么它将对数组中的每个元素进行查找和替换
- 如果同时需要对某个数组进行查找和替换,并且需要执行替换的元素少于查找到的元素的数量,那么多余的元素将用空字符串进行替换
- 如果是对一个数组进行查找,但只对一个字符串进行替换,那么替代字符串将对所有查找到的值起作用
该函数是区分大小写的,如果需要不区分大小写,可以使用str_ireplace()
该函数是二进制安全的
参数
参数 | 描述 |
---|---|
find | 必需。规定要查找的值 |
replace | 必需。规定替换find中的值的值 |
string | 必需。规定被搜索的字符串 |
count | 可选。一个变量,对替换数进行计数 |
返回值
返回带有替换值的字符串或数组
更新日志
PHP 版本 | 更新说明 |
---|---|
PHP 5.0 | 新增了 count 参数 |
PHP 4.3.3 | 修复函数的find和replace参数都为数组时将会遇到麻烦 会引起空的 find索引在内部指针没有更换到replace数组上时被忽略 |
PHP 4.0.5 | 大多数参数可以是一个数组 |
范例
把字符串 "Hello world!" 中的字符 "world" 替换成 "Peter"
<?php echo str_replace("world","Peter","Hello world!");
运行以上 PHP 范例,输出结果如下
Hello Peter!
范例 2
使用带有数组和 count 变量的 str_replace() 函数
<?php $arr = array("blue","red","green","yellow"); print_r(str_replace("red","pink",$arr,$i)); echo "Replacements: $i";
运行以上 PHP 范例,输出结果如下
Array ( [0] => blue [1] => pink [2] => green [3] => yellow ) Replacements: 1
范例 3
使用带有需要替换的元素少于查找到的元素的 str_replace() 函数
<?php $find = array("Hello","world"); $replace = array("B"); $arr = array("Hello","world","!"); print_r(str_replace($find,$replace,$arr));
运行以上 PHP 范例,输出结果如下
Array ( [0] => B [1] => [2] => ! )