首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

str_replace

(PHP 4, PHP 5, PHP 7)

str_replace - 用替换字符串替换所有出现的搜索字符串

描述

代码语言:javascript
复制
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()示例

代码语言:javascript
复制
<?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()陷阱的例子

代码语言:javascript
复制
<?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 →

扫码关注腾讯云开发者

领取腾讯云代金券

http://www.vxiaotou.com