Edit Report a Bug

    DOMCharacterData::before

    (PHP 8)

    DOMCharacterData::before — Добавляет узлы перед узлом

    Описание

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

    Добавление узлов перед символьными данными.

    <?php
    $doc     = new DOMDocument;
    $doc->loadXML("<container><![CDATA[world]]></container>");
    $cdata = $doc->documentElement->firstChild;

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

    echo     $doc->saveXML();
    ?>

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

    <?xml version="1.0"?>
<container>hello<beautiful/><![CDATA[world]]></container>

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

    add a note add a note

    User Contributed Notes

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