DOMNode::replaceChild

(PHP 5, PHP 7, PHP 8)

DOMNode::replaceChild Reemplaza un hijo

Descripción

public DOMNode::replaceChild(DOMNode $node, DOMNode $child): DOMNode|false

Esta función reemplaza el hijo child por el nuevo nodo especificado. Si node ya es un hijo, no será añadido una segunda vez. Si el reemplazo tiene éxito, el nodo antiguo será devuelto.

Parámetros

node

El nuevo nodo. Debe ser miembro del documento destino, es decir, creado por una de las métodos de DOMDocument->createXXX() o importado en el documento por DOMDocument::importNode.

child

El nodo antiguo.

Valores devueltos

El nodo antiguo o false si ocurre un error.

Errores/Excepciones

DOM_NO_MODIFICATION_ALLOWED_ERR

Lanzado si el nodo es de solo lectura o si el padre anterior del nodo a insertar es de solo lectura.

DOM_HIERARCHY_REQUEST_ERR

Lanzado si el nodo es de un tipo que no permite hijos del tipo del nodo node, o si el nodo a insertar es uno de los ancestros de este nodo o este nodo mismo.

DOM_WRONG_DOCUMENT_ERR

Emitido si node ha sido creado desde un documento diferente al que creó este nodo.

DOM_NOT_FOUND_ERR

Lanzado si child no es un hijo de este nodo.

Ver también