Reemplaza un hijo

Descripción

public DOMNode DOMNode::replaceChild ( DOMNode $newnode , DOMNode $oldnode )

Esta función reemplaza el hijo oldnode con es nuevo nodo pasado. Si el nuevo nodo ya es un hijo no será añadido una segunda vez. Si el reemplazo tiene éxito se devuelve el nodo antiguo.

Parámetros

newnode: El nuevo nodo. Debe ser un miembro del documento objetivo, es decir, creado con uno de los métodos DOMDocument->createXXX() o importado al documento por DOMDocument::importNode.
oldnode: El nodo antiguo.

Valores devueltos

El nodo antiguo o FALSE si ocurrió un error.

Errores/Excepciones

DOM_NO_MODIFICATION_ALLOWED_ERR: Lanazado si este nodo es de sólo lectura o si el padre anterior del nodo al que va a ser insertado es de sólo lectura.
DOM_HIERARCHY_REQUEST_ERR: Lanzado si el nodo es de un tipo que no permite hijos del tipo del nodo newnode, o si el nodo a colocar es uno de los progenitores de este nodo o es este nodo en sí.
DOM_WRONG_DOCUMENT_ERR: Lanzado si newnode fue creado desde un documento diferente que el que creó este nodo.
DOM_NOT_FOUND: Lanzado si oldnode no es un hijo de este nodo.

Ver también

DOMNode::appendChild() - Añade un nuevo hijo al final de los hijos
DOMNode::removeChild() - Elimina un hijo de la lista de hijos.