DOMNode::appendChild

(PHP 5, PHP 7, PHP 8)

DOMNode::appendChild — Adiciona um novo filho ao final dos filhos

Descrição

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

Esta função acrescenta um filho a uma lista existente de filhos, ou cria uma nova lista de filhos. O filho pode ser criado, por exemplo, com DOMDocument::createElement(), DOMDocument::createTextNode() etc. ou simplesmente pode usaando-se qualquer outro nó.

Ao usar um nó existente ele será movido.

Parâmetros

node

O nó filho anexado.

Valor Retornado

O nó adicionado ou false em caso de erro.

Erros/Exceções

DOM_NO_MODIFICATION_ALLOWED_ERR

Lançado se este nó for somente leitura, ou se o pai anterior do nó que está sendo inserido for somente leitura.

DOM_HIERARCHY_REQUEST_ERR

Lançada se este nó for de um tipo que não permite que filhos do tipo do node, ou se o nó a ser anexado for um dos ancestrais deste nó, ou se for este próprio nó.

DOM_WRONG_DOCUMENT_ERR

Lançado se node foi criado por um documento diferente do documento que criou este nó.

Exemplos

O exemplo a seguir irá adicionar um novo nó de elemento de um documento novo.

Example #1 Adicionando um nó filho

<?php

$doc = new DOMDocument;

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

echo $doc->saveXML();
?>

Example #2 Filhos aninhados

<?php

$doc = new DOMDocument;

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

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

echo $doc->saveXML();
?>

Veja Também