DOMNode::appendChild
Adds new child at the end of the children
Description
public DOMNodefalse DOMNode::appendChild(DOMNode $node
)
When using an existing node it will be moved.
Parameters
-
node
-
The appended child.
Return Values
The node added or false
on error.
Errors/Exceptions
-
DOM_NO_MODIFICATION_ALLOWED_ERR
-
Raised if this node is readonly or if the previous parent of the node
being inserted is readonly.
-
DOM_HIERARCHY_REQUEST_ERR
-
Raised if this node is of a type that does not allow children of the
type of the node
node, or if the node to
append is one of this node's ancestors or this node itself.
-
DOM_WRONG_DOCUMENT_ERR
-
Raised if node
was created from a different
document than the one that created this node.
Examples
The following example will add a new element node to a fresh document.
Example #1 Adding a child
<?php
$doc = new DOMDocument;
$node = $doc->createElement("para");
$newnode = $doc->appendChild($node);
echo $doc->saveXML();
?>
Example #2 Nested children
<?php
$doc = new DOMDocument;
$headNode = $doc->createElement("head");
$doc->appendChild($headNode);
$titleNode = $doc->createElement("title");
$headNode->appendChild($titleNode);
echo $doc->saveXML();
?>
See Also
- DOMChildNode::after
- DOMNode::insertBefore
- DOMNode::removeChild
- DOMNode::replaceChild