DOMCharacterData::replaceWith

(PHP 8)

DOMCharacterData::replaceWith — Замінює символьні дані новими вузлами

Опис

public DOMCharacterData::replaceWith(DOMNode|string ...$nodes): void

Замінює символьні дані новими вузлами nodes

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

nodes

Вузли для заміни. Рядки автоматично перетворюються на текстові вузли.

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

Функція не повертає значення після виконання.

Помилки

DOM_HIERARCHY_REQUEST_ERR

Виникає, якщо тип одного з переданих у параметрі nodes елементів не допускається в типі батьківського вузла, або якщо вузол, що додається, є одним з предків цього вузла або самим цим вузлом.

DOM_WRONG_DOCUMENT_ERR

Виникає, якщо один із переданих у параметрі nodes елементів було створено з документа, відмінного від цього, у якому було створено цей вузол.

список змін

Версия	Опис
8.3.0	Виклик методу на вузлі без батька тепер заборонено, щоб привести поведінку у відповідність до специфікації DOM. Раніше це викидало виняток DOMException з кодом DOM_HIERARCHY_REQUEST_ERR

Приклади

Приклад #1 Приклад использования методаDOMCharacterData::replaceWith()****

Заміна символьних даних на нові вузли.

Loading...
▶

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

<?xml version="1.0"?>
<container>beautiful<world/></container>

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

• DOMChildNode::replaceWith() - Замінює вузол на нові вузли
• DOMCharacterData::after() - Додає вузли після символьних даних
• DOMCharacterData::before() - Додає вузли перед вузлом
• DOMCharacterData::remove() - Видаляє символьні дані