Edit Report a Bug

DOMDocument::prepend

(PHP 8)

DOMDocument::prepend — Добавляет узлы перед первым дочерним узлом

public DOMDocument::prepend(DOMNode|string ...$nodes): void

Добавляет один или несколько узлов nodes в список дочерних узлов перед первым дочерним узлом.

nodes: Узлы, которые необходимо добавить. Строки автоматически преобразуются в текстовые узлы.

Функция не возвращает значения после выполнения.

DOM_HIERARCHY_REQUEST_ERR: Возникает, если тип одного из переданных в параметре nodes элементов не допускается в типе узла, или если добавляемый узел является одним из предков этого узла или самим этим узлом.
DOM_WRONG_DOCUMENT_ERR: Возникает, если один из переданных в параметре nodes элементов был создан из документа, отличного от того, в котором был создан этот узел.

Версия	Описание
8.3.0	Вызов этого метода на узле без документа владельца теперь работает. Ранее это выбрасывало исключение DOMException с кодом `DOM_HIERARCHY_REQUEST_ERR`.

Пример #1 Пример использования метода DOMDocument::prepend()

Добавление узлов перед корнем документа.

<?php
$doc = new DOMDocument;
$doc->loadXML("<world/>");

$doc->prepend($doc->createElement("hello"), "beautiful");

echo $doc->saveXML();
?>

Результат выполнения приведённого примера:

<?xml version="1.0"?>
<hello/>
beautiful
<world/>

There are no user contributed notes for this page.