DOMNode::replaceChild

(PHP 5, PHP 7, PHP 8)

DOMNode::replaceChild — Замінює дочірній вузол

Опис

public DOMNode::replaceChild(DOMNode $node, DOMNode $child): DOMNode|false

Функция заменяет дочерний узелchild новим вузлом. Якщо вузол node вже є дочірнім, то він не буде доданий вдруге. Якщо заміна пройшла успішно, то буде повернуто старий (замінний) вузол.

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

node

Новий вузол. Повинен бути частиною цільового документа, тобто створений за допомогою одного з методів DOMDocument->createXXX() або імпортований у документ через DOMDocument::importNode

child

Старий вузол.

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

Старий вузол або **false**в случае возникновения ошибки.

Помилки

DOM_NO_MODIFICATION_ALLOWED_ERR

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

DOM_HIERARCHY_REQUEST_ERR

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

DOM_WRONG_DOCUMENT_ERR

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

DOM_NOT_FOUND

Виникає, якщо childне является дочерним узлом данного узла.

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