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