(PHP 3> = 3.0.6, PHP 4, PHP 5)
str_replace - Замінює рядок пошуку на рядок заміни
mixed str_replace (mixed search, mixed replace, mixed subject [, int count])
Ця функція повертає рядок або масив subject, в якому все входження search замінені на replace. Якщо не потрібні складні правила пошуку / заміни, використання цієї функції краще ereg_replace () або preg_replace ().
З версії PHP 4.0.5, будь-який аргумент str_replace () може бути масивом.
У версіях молодше 4.3.3 ця функція містить помилку при одночасній передачі масивів в аргументах search і replace. Помилка полягає в тому, що порожні елементи масиву search пропускалися без переміщення до наступного елементу масиву replace. Ця помилка була виправлена в PHP 4.3.3. Якщо ваші скрипти використовували цю помилку, то в них потрібно видалити порожні елементи з масиву search перед викликом цієї функції.
Якщо subject - масив, пошук і заміна проводиться в кожному елементі цього масиву, і повертається також масив.
Якщо і search, і replace - масиви, то str_replace () використовує всі значення масиву search і відповідні значення масиву replace для пошуку і заміни в subject. Якщо в масиві replace менше елементів, ніж в search, як рядки заміни для решти значень буде використана порожній рядок. Якщо search - масив, а replace - рядок, то replace буде використана як рядок заміни для кожного елемента масиву search.
Приклад 1. Приклади використання str_replace ()
Зауваження: Ця функція безпечна для обробки даних в двійковій формі.
Зауваження: Починаючи з PHP 5.0.0 кількість проведених замін може бути отримано в необов'язковий аргумент count, який передається по посиланню. У версіях до PHP 5.0.0 цей аргумент недоступний.