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 не является дочерним узлом данного узла.

Смотрите также