DOMNode::insertBefore

(PHP 5, PHP 7)

DOMNode::insertBefore Добавляет новый дочерний узел перед указанным узлом

Описание

public DOMNode::insertBefore ( DOMNode $newnode , DOMNode $refnode = ? ) : DOMNode

Данная функция вставляет новый узел перед указанным узлом. Чтобы вносить изменения в добавленный дочерний узел, необходимо использовать возвращаемый узел.

При использовании существующего узла он будет перемещен.

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

newnode

Новый узел.

refnode

Контрольный узел. Если отсутствует, то newnode добавляется в конец списка потомков.

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

Добавленный узел.

Ошибки

DOM_NO_MODIFICATION_ALLOWED_ERR

Возникает, если узел доступен только для чтения или предыдущий родитель вставляемого узла доступен только для чтения.

DOM_HIERARCHY_REQUEST_ERR

Возникает, если тип узла не поддерживает потомков типа, который имеет узел newnode, или же если добавляемый узел является предком целевого узла или им самим.

DOM_WRONG_DOCUMENT_ERR

Возникает, если newnode создан в другом документе, отличном от того, в котором был создан этот узел.

DOM_NOT_FOUND

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

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

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