список параметрів
Шуканий шаблон. Може бути як рядком, так і масивом рядків.
Також доступні деякі модифікатори PCRE. включаючи застарілий # 'E # '(PREG_REPLACE_EVAL), специфічний тільки для цієї функції.
Рядок або масив рядків для заміни. Якщо цей параметр є рядком, а pattern є масивом, всі шаблони будуть замінені цим рядком. Якщо і pattern і replacement є масивами, кожен елемент pattern буде замінений відповідним елементом з replacement. Якщо масив replacement містить менше елементів, ніж масив pattern. то всі зайві шаблони з pattern будуть замінені порожніми рядками.
При заміні за шаблоном з використанням посилань на подмаскі може виникнути ситуація, коли безпосередньо за маскою слід цифра (наприклад, установка цифри відразу після збіглася маски). У такому разі не можна використовувати знайому нотацію виду \\ 1 для посилання на подмаскі. Запис, наприклад, \\ 11. збентежить preg_replace (). так як вона не зможе зрозуміти, чи хочете ви використовувати посилання \\ 1. за якої слід цифра 1 або ж ви хочете просто використовувати посилання \\ 11. за якої нічого не слід. Це непорозуміння можна усунути, якщо скористатися конструкцією \ $ 1. використовує ізольовану посилання $ 1. і наступну за нею цифру 1.
При використанні застарілого модифікатора e ця функція екранує деякі символи (а саме # '. ". \ І NULL) в рядках, що заміщають зворотні посилання. Це зроблено для посвідчення коректності синтаксису при використанні зворотних посилань всередині одинарних або подвійних лапок (наприклад, # 'Strlen (\ #' $ 1 \ # ') + strlen ( "$ 2") #'). Переконайтеся, що ви володієте синтаксисом обробки рядків PHP для того, щоб точно усвідомлювати, як буде виглядати інтерпретована рядок.
Рядок або масив рядків для пошуку та заміни.
Якщо subject є масивом, то пошук з заміною здійснюється для кожного елемента масиву subject. а повертається значення також буде масивом.
Максимально можливу кількість замін кожного шаблону для кожного рядка subject. За замовчуванням дорівнює -1 (без обмежень).
Якщо вказана, то ця змінна буде заповнена кількістю проведених замін.
значення, що повертаються
preg_replace () повертає масив, якщо параметр subject є масивом, інакше повертається рядок.
Якщо знайдені збіги, повертається нова версія subject. інакше subject повертається недоторканим, в разі помилки повертається NULL.
При використанні застарілого модифікатора "\ e" кидається помилка рівня E_DEPRECATED.