DOMNode::replaceChild

Replaces a child

&reftitle.description; public ``DOMNode``false```DOMNode::replaceChild` `DOMNode` `node` `DOMNode` `child`

This function replaces the child `child` with the passed new node. If the `node` is already a child it will not be added a second time. If the replacement succeeds the old node is returned.

&reftitle.parameters;

`node`

- The new node. It must be a member of the target document, i.e. created by one of the DOMDocument->createXXX() methods or imported in the document by domdocument.importnode.

`child`

- The old node.

&reftitle.returnvalues;

The old node or &false; if an error occur.

&reftitle.errors;

`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 put in 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.

`DOM_NOT_FOUND`

- Raised if `child` is not a child of this node.

&reftitle.seealso;

- `DOMChildNode::replaceWith`
- `DOMNode::appendChild`
- `DOMNode::removeChild`