Substitui os dados de caracteres por novos nós

# DOMCharacterData::replaceWith

(PHP 8)

DOMCharacterData::replaceWith — Substitui os dados de caracteres por novos nós

### Descrição

public function DOMCharacterData::replaceWith(DOMNode|string `...$nodes`): void

Substitui os dados de caracteres por novos `nodes`.

### Parâmetros

`nodes`

  Os nós de substituição. As strings são automaticamente convertidas em nós de texto.

### Valor Retornado

Nenhum valor é retornado.

### Erros/Exceções

`DOM_HIERARCHY_REQUEST_ERR`
  Emitido se o pai é 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 este 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 pai agora é uma operação sem efeito para alinhar o comportamento com a especificação do DOM. Anteriormente, era lançada uma exceção DOMException com código `DOM_HIERARCHY_REQUEST_ERR`.

### Exemplos

Exemplo #1 Exemplo de DOMCharacterData::replaceWith()

Substitui os dados de caracteres por novos nós.

    <?php
    $doc = new DOMDocument;
    $doc->loadXML("<container><![CDATA[hello]]></container>");
    $cdata = $doc->documentElement->firstChild;

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

    echo $doc->saveXML();
    ?>

O exemplo acima produzirá:

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

### Veja Também

- DOMChildNode::replaceWith() - Substitui o nó por novos nós
- DOMCharacterData::after() - Adiciona nós após os dados de caracteres
- DOMCharacterData::before() - Adiciona nós antes dos dados de caracteres
- DOMCharacterData::remove() - Remove o nó de dados de caractere

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