substr_replace

(PHP 4, PHP 5, PHP 7, PHP 8)

substr_replace — Замінює частину рядка

Опис

substr_replace(    array|string $string,    array|string $replace,    array|int $offset,    array|int|null $length = null): string|array

substr_replace() замінює частину рядка string, що починається із символу з порядковим номером offset та (необов'язковою) довжиною length, рядком replace та повертає результат.

Список параметрів

string

Вхідний рядок.

Також можна вказати масив рядків, у цьому випадку заміни відбуватимуться з кожним наданим рядком. У цьому випадку параметри replace offsetиlength можуть бути як скалярними значеннями – у цьому випадку ці значення будуть застосовані до кожного рядка, так і масивами – у цьому випадку відповідні елементи масивів будуть застосовані до кожного наданого рядка.

replace

Рядок заміни.

offset

Якщо offset позитивний, заміна починається з символу з порядковим номером offset рядки string

Якщо offset від'ємний, заміна починається із символу з порядковим номером offset, считая от конца строкиstring

length

Если аргумент положителен, то он представляет собой длину заменяемой подстроки в строкеstring. Якщо цей аргумент є негативним, він визначає кількість символів від кінця рядка stringна яких закінчується заміна. Цей аргумент необов'язковий і за промовчанням дорівнює strlen(string);, то есть замена до конца строкиstring. Зрозуміло, якщо length дорівнює нулю, то це еквівалентно вставці replaceвstring на вказаній позиції offset

Значення, що повертаються

Повертає результуючий рядок. Якщо string є масивом, що повертає масив.

список змін

Версия	Опис
8.0.0	length тепер допускає значення null.

Приклади

Приклад #1 Простий приклад використання substr_replace()

Loading...
▶

Приклад #2 Использованиеsubstr_replace()** для одночасної множинної заміни рядків**

Loading...
▶

Результат виконання наведеного прикладу:

A: YYY; B: YYY; C: YYY
A: AAA; B: BBB; C: CCC
A: AAAXX; B: BBBX; C: CCC

Примітки

Зауваження: Ця функція безпечна для обробки даних у двійковій формі.

Дивіться також

• str_replace() - Замінює всі входження рядка пошуку на рядок заміни
• substr() - Повертає підрядок
• Доступ до символу в рядку та його зміна