# Dom\CharacterData::before

(PHP 8 >= 8.4.0)

Dom\CharacterData::before — Ajoute des nœuds avant les données de caractère

### Description

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

Ajoute les `nodes` passés avant les données de caractère.

### Liste de paramètres

`nodes`

  Nœuds à ajouter avant le nœud. Les chaînes de caractères sont automatiquement convertie en des nœuds de texte.

### 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::before()

Ajoute des nœuds avant les données de caractères.

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

L'exemple ci-dessus va afficher :

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

### Voir aussi

- Dom\ChildNode::before() - Ajoute des nœuds avant le nœud
- Dom\CharacterData::after() - Ajoute des nœuds après les données