DOMNode::appendChild

(PHP 5)

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

Descrição

public DOMNode DOMNode::appendChild ( DOMNode $newnode )

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 a e.g. DOMDocument::createElement(), DOMDocument::createTextNode() etc. ou simplismente pode usar outro nó.

Parâmetros

newnode

Nó anexado.

Valor Retornado

O nó adicionado.

Erros

DOM_NO_MODIFICATION_ALLOWED_ERR

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

DOM_HIERARCHY_REQUEST_ERR

Lançada se este nó é de um tipo que não permite que filhos do        tipo newnode, ou se o nó para acrescentar é um dos antepassados ​​deste nó, ou é este nó em si.

DOM_WRONG_DOCUMENT_ERR

Lançado se newnode foi criado por um documento diferente do documento que criou esse 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();
?>

Veja Também