str_replace
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;
?>
注意
注意：此功能是二进制安全的。
警告
更换-顺序-gotcha
因为str_replace（）从左向右替换，所以在执行多次替换时可能会替换先前插入的值。另请参阅本文档中的示例。
注意：此功能区分大小写。使用str_ireplace（）进行不区分大小写的替换。
扩展内容
- str_ireplace（） - str_replace的不区分大小写的版本。
- substr_replace（） - 替换字符串的一部分中的文本
- preg_replace（） - 执行正则表达式搜索并替换
- strtr（） - 翻译字符或替换子字符串
← str_repeat
str_rot13 →
