« DOMDocument::normalizeDocumentDOMDocument::registerNodeClass »PHP ManualDOMDocument

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()****

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

Loading...

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

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

Дивіться також