DOMNode::replaceChild

DOMNode::replaceChild

Reemplaza un hijo

Descripción#

php public DOMNode::replaceChild(DOMNode $node, DOMNode $child): DOMNodephp

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 ???.

child
El nodo antiguo.

Valores devueltos#

El nodo antiguo o false si ocurre un error.

Errores/Excepciones#

Puede lanzar una DOMException con los siguientes códigos de error:

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.

Véase también#

DOMChildNode::replaceWith, DOMNode::appendChild, DOMNode::removeChild