DOMDocumentFragment::prepend

(PHP 8)

DOMDocumentFragment::prepend — Insere nós antes do primeiro nó filho

Descrição

public DOMDocumentFragment::prepend(DOMNode|string ...$nodes): void

Insere um ou muitos nodes na 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

Example #1 DOMDocumentFragment::prepend() exemplo

Insere nós antes da raiz do fragmento. 

<?php
$doc = new DOMDocument;
$fragment = $doc->createDocumentFragment();
$fragment->appendChild($doc->createElement("world"));

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

echo $doc->saveXML($fragment);
?>

O exemplo acima produzirá:

<hello/>beautiful<world/>

Veja Também