(PHP 4, PHP 5, PHP 7, PHP 8)
substr_replace — 替換字符串的子串
substr_replace() 在字符串 string 的副本中將由 start 和可選的 length 參數限定的子字符串使用 replacement 進(jìn)行替換。
string輸入字符串。
An array of strings can be provided, in which
case the replacements will occur on each string in turn. In this case,
the replacement, start
and length parameters may be provided either as
scalar values to be applied to each input string in turn, or as
arrays, in which case the corresponding array element will
be used for each input string.
replacement替換字符串。
start
如果 start 為正數，替換將從 string 的 start 位置開(kāi)始。
如果 start 為負數，替換將從 string 的倒數第 start 個(gè)位置開(kāi)始。
length
如果設定了這個(gè)參數并且為正數，表示 string 中被替換的子字符串的長(cháng)度。如果設定為負數，它表示待替換的子字符串結尾處距離 string 末端的字符個(gè)數。如果沒(méi)有提供此參數，那么它默認為 strlen( string ) （字符串的長(cháng)度）。當然，如果 length 為 0，那么這個(gè)函數的功能為將 replacement 插入到 string 的 start 位置處。
返回結果字符串。如果 string 是個(gè)數組，那么也將返回一個(gè)數組。
| 版本 | 說(shuō)明 |
|---|---|
| 4.3.3 | All parameters now accept arrays. |
示例 #1 substr_replace() 范例
<?php
$var = 'ABCDEFGH:/MNRPQR/';
echo "Original: $var<hr />\n";
/* 這兩個(gè)例子使用 “bob” 替換整個(gè) $var。*/
echo substr_replace($var, 'bob', 0) . "<br />\n";
echo substr_replace($var, 'bob', 0, strlen($var)) . "<br />\n";
/* 將 “bob” 插入到 $var 的開(kāi)頭處。*/
echo substr_replace($var, 'bob', 0, 0) . "<br />\n";
/* 下面兩個(gè)例子使用 “bob” 替換 $var 中的 “MNRPQR”。*/
echo substr_replace($var, 'bob', 10, -1) . "<br />\n";
echo substr_replace($var, 'bob', -7, -1) . "<br />\n";
/* 從 $var 中刪除 “MNRPQR”。*/
echo substr_replace($var, '', 10, -1) . "<br />\n";
?>
示例 #2 Using substr_replace() to replace multiple strings at once
<?php
$input = array('A: XXX', 'B: XXX', 'C: XXX');
// A simple case: replace XXX in each string with YYY.
echo implode('; ', substr_replace($input, 'YYY', 3, 3))."\n";
// A more complicated case where each replacement is different.
$replace = array('AAA', 'BBB', 'CCC');
echo implode('; ', substr_replace($input, $replace, 3, 3))."\n";
// Replace a different number of characters each time.
$length = array(1, 2, 3);
echo implode('; ', substr_replace($input, $replace, 3, $length))."\n";
?>
以上例程會(huì )輸出：
A: YYY; B: YYY; C: YYY A: AAA; B: BBB; C: CCC A: AAAXX; B: BBBX; C: CCC
注意: 此函數可安全用于二進(jìn)制對象。