(PHP 8)
DOMElement::prepend — Добавляет узлы перед первым дочерним узлом
Добавляет один или несколько узлов nodes в список дочерних узлов перед первым дочерним узлом.
nodesУзлы, которые необходимо добавить. Строки автоматически преобразуются в текстовые узлы.
Функция не возвращает значения после выполнения.
DOM_HIERARCHY_REQUEST_ERR
Возникает, если тип одного из переданных в параметре nodes элементов не допускается в типе узла,
или если добавляемый узел является одним из предков этого узла или самим этим узлом.
DOM_WRONG_DOCUMENT_ERR
Возникает, если один из переданных в параметре nodes элементов был создан из документа,
отличного от того, в котором был создан этот узел.
| Версия | Описание |
|---|---|
| 8.3.0 |
Вызов этого метода на узле без документа владельца теперь работает.
Раньше метод выбрасывал исключение
DOMException с кодом
DOM_HIERARCHY_REQUEST_ERR.
|
Пример #1 Пример использования метода DOMElement::prepend()
Добавление узлов в элемент «container».
<?php
$doc = new DOMDocument;
$doc->loadXML("<container> world</container>");
$world = $doc->documentElement;
$world->prepend($doc->createElement("hello"), "beautiful");
echo $doc->saveXML();
?>Результат выполнения приведённого примера:
<?xml version="1.0"?> <container><hello/>beautiful world</container>