(PHP 4, PHP 5)
substr_replace — Заменя част от низ
substr_replace() заменя част от низа string , заграден посредством параметрите start (начален знак) и (незадължителен) length (брой знаци), с низ указан чрез replacement .
Входният низ.
Низът за замяна.
Ако start е положително число, замяната ще започне от знак с пореден номер start , считано от началото на низа string .
Ако start е отрицателно число, замяната ще започне от знак с пореден номер start , считано от края на низа string .
Ако е указан броят и е положителен, то той означава дължината на частта от string , която трябва да бъде заменена. Ако е отрицателен - представлява броя на знаците от края на string , до които да спре замяната. Ако параметърът не е указан, стойността му по подразбиране е strlen( string ) т.е. знакът, на който ще спре замяната, е и края на низа string . Разбира се, ако length е нула, ефекта на функцията ще е вмъкване на низа replacement в string от указаното отместване start
Връща се резултатния низ. Ако string е масив, то се връща масив.
Example #1 Пример за substr_replace()
<?php
$var = 'ABCDEFGH:/MNRPQR/';
echo "Original: $var<hr />\n";
/* Заменяне на всички $var с 'bob'. */
echo substr_replace($var, 'bob', 0) . "<br />\n";
echo substr_replace($var, 'bob', 0, strlen($var)) . "<br />\n";
/* Вмъкване на 'bob' в началото на $var. */
echo substr_replace($var, 'bob', 0, 0) . "<br />\n";
/* Заменяне на 'MNRPQR' във $var с 'bob'. */
echo substr_replace($var, 'bob', 10, -1) . "<br />\n";
echo substr_replace($var, 'bob', -7, -1) . "<br />\n";
/* Премахване на 'MNRPQR' от $var. */
echo substr_replace($var, '', 10, -1) . "<br />\n";
?>
Забележка: Тази функция е двоично сигурна (binary-safe).