DOMNode->replaceChild()
(no version information, might be only in CVS)
DOMNode->replaceChild() --
Replaces a child
Description
class
DOMNode {
DOMNode
replaceChild ( DOMNode newnode, DOMNode oldnode )
}
This function replaces the child oldnode
with the passed new node. If the new node is already a child it
will not be added a second time. If the replacement succeeds the
old node is returned.
Parameters
- newnode
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().
- oldnode
The old node.
Return Values
The old node or FALSE if an error occur.
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
put in 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.
- DOM_NOT_FOUND
Raised if oldnode is not a child of this node.
Copyright © 1997 - 2007 by the PHP Documentation Group. This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later. A copy of the Open Publication License is distributed with this manual, the latest version is presently available at http://www.opencontent.org/openpub/.
Please see full copyright text at http://www.php.net/manual/en/copyright.php
Original version of the above documentation is available at http://www.php.net/manual/en/
