# Dom\CharacterData::replaceWith

(PHP 8 >= 8.4.0)

Dom\CharacterData::replaceWith — Remplace les données par de nouveaux nœuds

### Description

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

Remplace les données par de nouveaux `nodes`.

### Liste de paramètres

`nodes`

  Les nœuds de remplacement.

### Valeurs de retour

Aucune valeur n'est retournée.

### Erreurs / Exceptions

`DOM_HIERARCHY_REQUEST_ERR`

  Levée si le parent est d'un type qui n'autorise pas les enfants du type de l'un des `nodes` transmis, ou si le nœud à insérer est l'un des ancêtres de ce nœud ou ce nœud lui-même.

`DOM_WRONG_DOCUMENT_ERR`

  Levée si l'un des `nodes` transmis a été créé à partir d'un document différent de celui qui a créé ce nœud.

### Exemples

Exemple #1 Exemple de Dom\CharacterData::replaceWith()

Remplace les données de caractères par de nouveaux nœuds.

`<?php
$doc = Dom\XMLDocument::createFromString("<container><![CDATA[hello]]></container>");
$cdata = $doc->documentElement->firstChild;
$cdata->replaceWith("beautiful", $doc->createElement("world"));
echo $doc->saveXML();
?>`

L'exemple ci-dessus va afficher :

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

### Voir aussi

- Dom\ChildNode::replaceWith() - Remplace le nœud par de nouveaux nœuds
- Dom\CharacterData::after() - Ajoute des nœuds après les données
- Dom\CharacterData::before() - Ajoute des nœuds avant les données de caractère
- Dom\CharacterData::remove() - Supprime le nœud de données de caractère