DOMNode::insertBefore
(PHP 5, PHP 7)
DOMNode::insertBefore — Добавляет новый дочерний узел перед указанным узлом
Описание
Данная функция вставляет новый узел перед указанным узлом. Чтобы вносить изменения в добавленный дочерний узел, необходимо использовать возвращаемый узел.
При использовании существующего узла он будет перемещен.
Список параметров
-
newnode
-
Новый узел.
-
refnode
-
Контрольный узел. Если отсутствует, то
newnode
добавляется в конец списка потомков.
Возвращаемые значения
Добавленный узел.
Ошибки
-
DOM_NO_MODIFICATION_ALLOWED_ERR
-
Возникает, если узел доступен только для чтения или предыдущий родитель вставляемого узла доступен только для чтения.
-
DOM_HIERARCHY_REQUEST_ERR
-
Возникает, если тип узла не поддерживает потомков типа, который имеет узел
newnode
, или же если добавляемый узел является предком целевого узла или им самим. -
DOM_WRONG_DOCUMENT_ERR
-
Возникает, если
newnode
создан в другом документе, отличном от того, в котором был создан этот узел. -
DOM_NOT_FOUND
-
Возникает, если
refnode
не является дочерним узлом данного узла.