DOMElement::prepend

(PHP 8)

DOMElement::prepend — Prepends nodes before the first child node

Описание

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

Prepends one or many nodes to the list of children before the first child node.

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

nodes

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

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

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

Ошибки

DOM_HIERARCHY_REQUEST_ERR

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

DOM_WRONG_DOCUMENT_ERR

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

Примеры

Пример #1 DOMElement::prepend() example

Prepends nodes in the container element.

<?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>

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