Ajoute des nœuds avant le premier nœud enfant

# DOMDocument::prepend

(PHP 8)

DOMDocument::prepend — Ajoute des nœuds avant le premier nœud enfant

### Description

public function DOMDocument::prepend(DOMNode|string `...$nodes`): void

Ajoute un ou plusieurs `nodes` à la liste des enfants avant le premier nœud enfant.

### Liste de paramètres

`nodes`

  Les nœuds à ajouter. Les chaînes de caractères sont automatiquement converties en des nœuds de texte.

### Valeurs de retour

Aucune valeur n'est retournée.

### Erreurs / Exceptions

`DOM_HIERARCHY_REQUEST_ERR`
  Levée si ce nœud 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.

### Historique

Version | Description
--- | ---
8.3.0 | Appeler cette méthode sur un nœud sans document propriétaire fonctionne désormais. Auparavant, cela déclenchait une DOMException avec le code `DOM_HIERARCHY_REQUEST_ERR`.

### Exemples

Exemple #1 Exemple de DOMDocument::prepend()

Ajoute des nœuds avant le nœud racine du document.

    <?php
    $doc = new DOMDocument;
    $doc->loadXML("<world/>");

    $doc->prepend($doc->createElement("hello"), "beautiful");

    echo $doc->saveXML();
    ?>

L'exemple ci-dessus va afficher :

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

### Voir aussi

- DOMParentNode::prepend() - Ajoute des nœuds avant le premier nœud enfant
- DOMDocument::append() - Ajoute des nœuds après le dernier nœud enfant

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open