# PHP substr_replace() 函数
[ PHP String 参考手册](php-ref-string.html)
## 实例
把 "Hello" 替换成 "world"：
echo substr_replace("Hello","world",0);
[运行实例 »](/try/showphp.php?filename=demo_func_string_substr_replace)
---
## 定义和用法
substr_replace() 函数把字符串的一部分替换为另一个字符串。
**注释：**如果 start 参数是负数且 length 小于或者等于 start，则 length 为 0。
**注释：**该函数是二进制安全的。
---
## 语法
substr_replace(*string,replacement,start,length*)
| 参数 | 描述 |
|---|---|
| *string* | 必需。规定要检查的字符串。 |
| *replacement* | 必需。规定要插入的字符串。 |
| *start* | 必需。规定在字符串的何处开始替换。- 正数 - 在字符串的指定位置开始 - 负数 - 在从字符串结尾的指定位置开始 - 0 - 在字符串中的第一个字符处开始 |
| *length* | 可选。规定要替换多少个字符。默认是与字符串长度相同。- 正数 - 被替换的字符串长度 - 负数 - 从字符串末端开始的被替换字符数 - 0 - 插入而非替换 |
## 技术细节
| 返回值： | 返回被替换的字符串。如果 string 是一个数组，则返回数组。 |
|:--|---|
| PHP 版本： | 4+ |
| 更新日志： | 自 PHP 4.3.3 起，所有参数都接受数组。 |
---
## 更多实例
## 实例 1
从字符串的第 6 个位置开始替换（把 "world" 替换成 "earth"）：
echo substr_replace("Hello world","earth",6);
[运行实例 »](/try/showphp.php?filename=demo_func_string_substr_replace2)
## 实例 2
从字符串结尾的第 5 个位置开始替换（把 "world" 替换成 "earth"）：
echo substr_replace("Hello world","earth",-5);
[运行实例 »](/try/showphp.php?filename=demo_func_string_substr_replace3)
## 实例 3
在 "world" 开头插入 "Hello"：
echo substr_replace("world","Hello ",0,0);
[运行实例 »](/try/showphp.php?filename=demo_func_string_substr_replace4)
## 实例 4
一次性替换多个字符串。把每个字符串中的 "AAA" 替换成 "BBB"：
$replace = array("1: AAA","2: AAA","3: AAA");
echo implode("<br>",substr_replace($replace,'BBB',3,3));
[运行实例 »](/try/showphp.php?filename=demo_func_string_substr_replace5)
---
[ PHP String 参考手册](php-ref-string.html)