PHP 8.3.27 Released!

DOMCharacterData::replaceWith

(PHP 8)

DOMCharacterData::replaceWith โ€” Replaces the character data with new nodes

Beschreibung

public DOMCharacterData::replaceWith(DOMNode|string ...$nodes): void

Replaces the character data with new nodes.

Parameter-Liste

nodes

The replacement nodes. Strings are automatically converted to text nodes.

Rรผckgabewerte

Es wird kein Wert zurรผckgegeben.

Fehler/Exceptions

DOM_HIERARCHY_REQUEST_ERR

Wird ausgelรถst, wenn der Elternteil von einem Typ ist, der keine Kinder vom Typ eines der รผbergebenen nodes zulรคsst, oder wenn der einzufรผgende Knoten einer der Vorfahren dieses Knotens oder dieser Knoten selbst ist.

DOM_WRONG_DOCUMENT_ERR

Wird ausgelรถst, wenn einer der รผbergebenen nodes aus einem anderen Dokument erstellt wurde als dem, das diesen Knoten erstellt hat.

Changelog

Version Beschreibung
8.3.0 Calling this method on a node without a parent is now a no-op to align the behaviour with the DOM specification. Zuvor fรผhrte dies zu einer DOMException mit dem Code DOM_HIERARCHY_REQUEST_ERR.

Beispiele

Beispiel #1 DOMCharacterData::replaceWith() example

Replaces the character data with new nodes.

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

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

echo
$doc->saveXML();
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

Siehe auch

๏ผ‹add a note

User Contributed Notes

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