DOMNode::appendChild

(PHP 5, PHP 7, PHP 8)

DOMNode::appendChild — Ajoute un nouveau fils à la fin des fils

Description

public DOMNode::appendChild(DOMNode $node): DOMNode|false

Cette fonction ajoute un fils à une liste de fils existante ou crée une nouvelle liste de fils. Le fils peut être créé avec, e.g. DOMDocument::createElement(), DOMDocument::createTextNode(), etc. ou simplement en utilisant tout autre nœud.

Lors de l'utilisation d'un nœud existant, il sera supprimé.

Liste de paramètres

node

Le nœud fils à ajouter.

Valeurs de retour

Le nœud fils ajouté ou false en cas d'erreur.

Erreurs / Exceptions

DOM_NO_MODIFICATION_ALLOWED_ERR

Lancé si le nœud est en lecture seule ou si le parent précédent le nœud à insérer est en lecture seule.

DOM_HIERARCHY_REQUEST_ERR

Lancé si le nœud est d'un type qui n'autorise pas d'enfant du type du nœud node, ou si le nœud à ajouter est un des nœuds ancêtres ou ce nœud lui-même.

DOM_WRONG_DOCUMENT_ERR

Lancé si node a été créé depuis un document différent que celui qui a créé ce nœud.

Exemples

L'exemple suivant ajoutera un nouveau nœud à un document nouveau.

Exemple #1 Ajout d'un fils

<?php

$doc = new DOMDocument;

$node = $doc->createElement("para");
$newnode = $doc->appendChild($node);

echo $doc->saveXML();
?>

Exemple #2 Enfant imbriqué

<?php

$doc = new DOMDocument;

$headNode = $doc->createElement("head");
$doc->appendChild($headNode);

$titleNode = $doc->createElement("title");
$headNode->appendChild($titleNode);

echo $doc->saveXML();
?>

Voir aussi