Edit Report a Bug

DOMDocument::replaceChildren

(PHP 8 >= 8.3.0)

DOMDocument::replaceChildren — Substitui filhos no documento

Descrição

public DOMDocument::replaceChildren(DOMNode|string ...$nodes): void

Substitui os filhos no documento por novos nodes.

Parâmetros

nodes: Os nós que substituirão os filhos. Strings são automaticamente convertidas em nós de texto.

Valor Retornado

Nenhum valor é retornado.

Erros/Exceções

DOM_HIERARCHY_REQUEST_ERR: Emitido se este nó é de um tipo que não permite filhos do tipo de um dos nodes informados, ou se o nó a ser inserido é um dos ancestrais deste nó, ou o próprio nó.
DOM_WRONG_DOCUMENT_ERR: Emitido se um dos nodes informados foi criado a partir de um documento diferente daquele que criou este nó.

Registro de Alterações

Versão	Descrição
8.3.0	Chamar este método em um nó sem um documento proprietário agora funciona. Anteriormente, era lançada uma exceção DOMException com código `DOM_HIERARCHY_REQUEST_ERR`.

Exemplos

Exemplo #1 DOMDocument::replaceChildren() exemplo

Substitui os filhos por novos nodes.

<?php
$doc = new DOMDocument;
$doc->loadXML("<container><hello/></container>");

$doc->replaceWith("beautiful", $doc->createElement("world"));

echo $doc->saveXML();
?>

O exemplo acima produzirá:

<?xml version="1.0"?>
beautiful
<world/>

Veja Também

DOMParentNode::replaceChildren() - Substitui filhos no nó
DOMDocument::append() - Adiciona nós após o último nó filho
DOMDocument::prepend() - Adiciona nós antes do primeiro nó filho

add a note

User Contributed Notes

There are no user contributed notes for this page.