Adiciona nós antes do primeiro nó filho

# DOMDocument::prepend

(PHP 8)

DOMDocument::prepend — Adiciona nós antes do primeiro nó filho

### Descrição

public function DOMDocument::prepend(DOMNode|string `...$nodes`): void

Adiciona um ou muitos `nodes` à lista de filhos antes do primeiro nó filho.

### Parâmetros

`nodes`

  Os nós a serem inseridos. 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 Exemplo de DOMDocument::prepend()

Adiciona nós antes da raiz do documento.

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

    $doc->prepend($doc->createElement("hello"), "beautiful");

    echo $doc->saveXML();
    ?>

O exemplo acima produzirá:

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

### Veja Também

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

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