Reemplaza un hijo

# DOMNode::replaceChild

(PHP 5, PHP 7, PHP 8)

DOMNode::replaceChild — Reemplaza un hijo

### Descripción

public function 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

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.

### Ver también

- DOMChildNode::replaceWith() - Reemplaza el nodo por nuevos nodos
- DOMNode::appendChild() - Añade un nuevo hijo al final de los hijos
- DOMNode::removeChild() - Elimina un hijo de la lista de hijos

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open