Dom\CharacterData::replaceWith

(PHP 8 >= 8.4.0)

Dom\CharacterData::replaceWith — Заменяет символьные данные новыми узлами

Описание

public function Dom\CharacterData::replaceWith(Dom\Node|string ...$nodes): void

Заменяет символьные данные новыми узлами nodes.

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

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

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

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

Ошибки

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

Примеры

Пример #1 Пример использования метода Dom\CharacterData::replaceWith()

Заменяет символьные данные новыми узлами.

<?php
$doc = Dom\XMLDocument::createFromString("<container><![CDATA[hello]]></container>");
$cdata = $doc->documentElement->firstChild;

$cdata->replaceWith("beautiful", $doc->createElement("world"));

echo $doc->saveXML();
?>

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

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

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

Dom\ChildNode::replaceWith() - Заменяет узел на новые узлы
Dom\CharacterData::after() - Добавляет узлы после символьных данных
Dom\CharacterData::before() - Добавляет узлы перед символьными данными
Dom\CharacterData::remove() - Удаляет символьные данные

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

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

＋Добавить

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

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