PHP Manual
Prev |  | Next

# DOMNode->appendChild()

(no version information, might be only in CVS)

DOMNode->appendChild() -- Adds new child at the end of the children

## Description

class DOMNode {
DOMNode appendChild ( DOMNode newnode )
}

This functions appends a child to an existing list of children or creates a new list of children. The child can be created with e.g. DOMDocument->createElement(), DOMDocument->createTextNode() etc. or simply by using any other node.

## Parameters

newnode

  The appended child.

## Return Values

The node added.

## 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 newnode node, or if the node to append is one of this node's ancestors or this node itself.

`DOM_WRONG_DOCUMENT_ERR`

  Raised if newnode 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(); ?>`

## See Also

DOMNode->removeChild()
DOMNode->replaceChild()

Prev | Home | Next
DOMNamedNodeMap->item() | Up | DOMNode->cloneNode()