str_replace
(PHP 4, PHP 5, PHP 7)
str_replace - 用替换字符串替换所有出现的搜索字符串
描述
mixed str_replace ( mixed $search , mixed $replace , mixed $subject [, int &$count ] )
该函数返回一个字符串或一个数组,其中主题中的所有搜索出现都替换为给定的替换值。
如果你不需要更换规则(比如正则表达式),你应该总是使用这个函数而不是preg_replace()。
参数
如果search和replace是数组,则str_replace()从每个数组中获取一个值,并使用它们在主题上进行search和replace。 如果replace的值比搜索更少,那么replace值的其余部分将使用空字符串。 如果search是一个数组而replace是一个字符串,那么这个替换字符串用于每个search值。 尽管如此,反过来也是没有意义的。
如果search
或者replace
是数组,它们的元素会从最初处理到最后。
search
正在搜索的值,否则称为指针。一个数组可能被用来指定多个指针。
replace
替代值,替代找到的search
值。一个数组可能被用来指定多个替换。
subject
正在搜索并替换的字符串或数组,也称为haystack。
如果subject
是一个数组,那么搜索和替换将与每个条目执行subject
,并且返回值也是一个数组。
count
如果通过,这将被设置为执行的替换次数。
返回值
该函数返回一个字符串或一个数组,其中包含替换值。
例子
示例#1 基本的str_replace()示例
<?php
//?Provides:?<body?text='black'>
$bodytag?=?str_replace("%body%",?"black",?"<body?text='%body%'>");
//?Provides:?Hll?Wrld?f?PHP
$vowels?=?array("a",?"e",?"i",?"o",?"u",?"A",?"E",?"I",?"O",?"U");
$onlyconsonants?=?str_replace($vowels,?"",?"Hello?World?of?PHP");
//?Provides:?You?should?eat?pizza,?beer,?and?ice?cream?every?day
$phrase??=?"You?should?eat?fruits,?vegetables,?and?fiber?every?day.";
$healthy?=?array("fruits",?"vegetables",?"fiber");
$yummy???=?array("pizza",?"beer",?"ice?cream");
$newphrase?=?str_replace($healthy,?$yummy,?$phrase);
//?Provides:?2
$str?=?str_replace("ll",?"",?"good?golly?miss?molly!",?$count);
echo?$count;
?>
示例#2 潜在的str_replace()陷阱的例子
<?php
//?Order?of?replacement
$str?????=?"Line?1\nLine?2\rLine?3\r\nLine?4\n";
$order???=?array("\r\n",?"\n",?"\r");
$replace?=?'<br?/>';
//?Processes?\r\n's?first?so?they?aren't?converted?twice.
$newstr?=?str_replace($order,?$replace,?$str);
//?Outputs?F?because?A?is?replaced?with?B,?then?B?is?replaced?with?C,?and?so?on...
//?Finally?E?is?replaced?with?F,?because?of?left?to?right?replacements.
$search??=?array('A',?'B',?'C',?'D',?'E');
$replace?=?array('B',?'C',?'D',?'E',?'F');
$subject?=?'A';
echo?str_replace($search,?$replace,?$subject);
//?Outputs:?apearpearle?pear
//?For?the?same?reason?mentioned?above
$letters?=?array('a',?'p');
$fruit???=?array('apple',?'pear');
$text????=?'a?p';
$output??=?str_replace($letters,?$fruit,?$text);
echo?$output;
?>
注意
注意:此功能是二进制安全的。
警告
因为str_replace()从左向右替换,所以在执行多次替换时可能会替换先前插入的值。另请参阅本文档中的示例。
注意:此功能区分大小写。使用str_ireplace()进行不区分大小写的替换。
扩展内容
- str_ireplace() - str_replace的不区分大小写的版本。
- substr_replace() - 替换字符串的一部分中的文本
- preg_replace() - 执行正则表达式搜索并替换
- strtr() - 翻译字符或替换子字符串
← str_repeat
str_rot13 →
本文档系腾讯云开发者社区成员共同维护,如有问题请联系 cloudcommunity@tencent.com