Заменяет дочерний узел

# DOMNode::replaceChild

(PHP 5, PHP 7, PHP 8)

DOMNode::replaceChild — Заменяет дочерний узел

### Описание

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

Функция заменяет дочерний узел `child` новым узлом. Если узел `node` уже является дочерним, то он не будет добавлен во второй раз. Если замена прошла успешно, то будет возвращён старый (заменяемый) узел.

### Список параметров

`node`

  Новый узел. Должен быть частью целевого документа, то есть создан посредством одного из методов DOMDocument->createXXX() или импортирован в документ через DOMDocument::importNode.

`child`

  Старый узел.

### Возвращаемые значения

Старый узел или `false` в случае возникновения ошибки.

### Ошибки

Может выбросить исключение DOMException со следующими кодами ошибок:

`DOM_NO_MODIFICATION_ALLOWED_ERR`

  Возникает, если узел доступен только для чтения или предыдущий родитель вставляемого узла доступен только для чтения.

`DOM_HIERARCHY_REQUEST_ERR`

  Возникает, если тип узла не поддерживает потомков типа, который имеет узел `node`, или же если добавляемый узел является предком целевого узла или им самим.

`DOM_WRONG_DOCUMENT_ERR`

  Возникает, если `node` создан в другом документе, отличном от того, в котором был создан этот узел.

`DOM_NOT_FOUND_ERR`

  Возникает, если `child` не является дочерним узлом данного узла.

### Смотрите также

- DOMChildNode::replaceWith() - Заменяет узел на новые узлы
- DOMNode::appendChild() - Добавляет новый дочерний узел в конец списка потомков
- DOMNode::removeChild() - Удаляет дочерний узел из списка потомков

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