Statement on glibc/iconv Vulnerability

DOMElement::before

(PHP 8)

DOMElement::beforeДобавляет узлы перед элементом

Описание

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

Добавляет переданные узлы nodes перед элементом.

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

nodes

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

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

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

Ошибки

DOM_HIERARCHY_REQUEST_ERR

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

DOM_WRONG_DOCUMENT_ERR

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

Список изменений

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

Примеры

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

Добавление узлов перед элементом «hello».

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

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

echo
$doc->saveXML();
?>

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

hello
<beautiful/>
<world/>

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

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top