# 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` con es nuevo nodo `node` proporcionado. 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

`node`

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

`child`

  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 `node`, 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 `node` fue creado desde un documento diferente que el que creó este nodo.

`DOM_NOT_FOUND`

  Lanzado si `child` no es un hijo de este nodo.

### Ver también

- DOMChildNode::replaceWith() - Replaces the node with new nodes
- DOMNode::appendChild() - Añade un nuevo hijo al final de los hijos
- DOMNode::removeChild() - Elimina un hijo de la lista de hijos.