DOMNode::insertBefore

(PHP 5, PHP 7, PHP 8)

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

Описание

public DOMNode::insertBefore(DOMNode $node, ?DOMNode $child = null): DOMNode|false

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

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

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

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

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

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

Ошибки

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

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

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