DOMCharacterData::before

(PHP 8)

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

Описание

public function 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>

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

DOMChildNode::before() - Добавляет узлы перед узлом
DOMCharacterData::after() - Добавляет узлы после символьных данных

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы