phpm.ru | Заменяет дочерний узел

Описание

public DOMNode::replaceChild ( DOMNode $newnode , DOMNode $oldnode ) : DOMNode

Функция заменяет дочерний узел oldnode новым узлом. Если узел newnode уже является дочерним, то он не будет добавлен во второй раз. Если замена прошла успешно, то будет возвращен старый (заменяемый) узел.

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

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

Возвращаемые значения

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

Ошибки

DOM_NO_MODIFICATION_ALLOWED_ERR: Возникает, если узел доступен только для чтения или предыдущий родитель вставляемого узла доступен только для чтения.
DOM_HIERARCHY_REQUEST_ERR: Возникает, если тип узла не поддерживает потомков типа, который имеет узел newnode, или же если добавляемый узел является предком целевого узла или им самим.
DOM_WRONG_DOCUMENT_ERR: Возникает, если newnode создан в другом документе, отличном от того, в котором был создан этот узел.
DOM_NOT_FOUND: Возникает, если oldnode не является дочерним узлом данного узла.

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

DOMNode::appendChild() - Добавляет новый дочерний узел в конец списка потомков
DOMNode::removeChild() - Удаляет дочерний узел из списка потомков