DOMElement::prepend
(PHP 8)
DOMElement::prepend — Adiciona nós antes do primeiro nó filho
Descrição
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
Example #1 DOMElement::prepend() exemplo
Adiciona nós no elemento "container".
<?php
$doc = new DOMDocument;
$doc->loadXML("<container> world</container>");
$world = $doc->documentElement;
$world->prepend($doc->createElement("hello"), "beautiful");
echo $doc->saveXML();
?>
O exemplo acima produzirá:
<?xml version="1.0"?> <container><hello/>beautiful world</container>
Veja Também
- DOMParentNode::prepend() - Insere nós antes do primeiro nó filho
- DOMElement::append() - Adiciona nós após o último nó filho