Edit Report a Bug

    DOMDocumentFragment::prepend

    (PHP 8)

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

    Описание

    public DOMDocumentFragment::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 Пример использования метода DOMDocumentFragment::prepend()

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

    <?php
    $doc     = new DOMDocument;
    $fragment = $doc->createDocumentFragment();
    $fragment->appendChild($doc->createElement("world"));

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

    echo     $doc->saveXML($fragment);
    ?>

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

    <hello/>beautiful<world/>

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

    add a note add a note

    User Contributed Notes

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