str_replace
(PHP 4, PHP 5, PHP 7, PHP 8)
str_replace — Замінює всі входження рядка пошуку на рядок заміни
Опис
str_replace( array|string $search, array|string $replace, string|array $subject, int &$count = null): string|array
Ця функція повертає рядок або масив, в якому всі входження searchвsubject замінені на replace
Щоб замінити текст на основі шаблону, а не фіксованого рядка, скористайтеся функцією preg_replace()
Список параметрів
Якщо searchиreplace - масиви, то str_replace() використовує кожне значення з відповідного масиву для пошуку та заміни в subject. Якщо в масиві replace менше елементів, ніж у search, як рядок заміни для значень, що залишилися, буде використаний порожній рядок. Якщо search- массив, аreplace - рядок, то цей рядок заміни буде використаний для кожного елемента масиву search. Зворотний випадок не має сенсу.
Якщо searchилиreplace є масивами, їх елементи будуть оброблені від першого до останнього.
search
Шукане значення, також відоме як needle (голка). Для безлічі значень, що шукаються, можна використовувати масив.
replace
Значення заміни, буде використано для заміни значень, що шукаються search. Для багатьох значень можна використовувати масив.
subject
Рядок або масив, в якому проводиться пошук і заміна, також відомий як haystack(стог сена).
Якщо subject є масивом, то пошук із заміною буде здійснюватися над кожним елементом subject, а результатом функції також буде масив.
count
Якщо передано, то буде встановлено кількість проведених замін.
Значення, що повертаються
Ця функція повертає рядок або масив із заміненими значеннями.
Приклади
Приклад #1 Приклади використання str_replace()
Приклад #2 Приклади потенційних трюків з str_replace()
Примітки
Зауваження: Ця функція безпечна для обробки даних у двійковій формі.
Застереження
Зауваження щодо порядку заміни
Так какstr_replace() здійснює заміну ліворуч, то при використанні множинних замін вона може замінити раніше вставлене значення на інше. Дивіться приклади на цій сторінці.
Зауваження :
Ця функція чутлива до регістру. Використовуйте str_ireplace() для заміни без урахування регістру.
Дивіться також
- str_ireplace() - Реєстронезалежний варіант функції str_replace
- substr_replace() - Замінює частину рядка
- preg_replace() - Виконує пошук та заміну за регулярним виразом
- strtr() - Перетворює задані символи або замінює підрядки