PHP 8.5.0 Alpha 2 available for testing

DOMElement::prepend

(PHP 8)

DOMElement::prependAñade nodos antes del primer hijo

Descripción

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

Añade uno o varios nodes a la lista de hijos antes del primer nodo hijo.

Parámetros

nodes

Los nodos a añadir. Las cadenas de caracteres se convierten automáticamente en nodos de texto.

Valores devueltos

No se retorna ningún valor.

Errores/Excepciones

DOM_HIERARCHY_REQUEST_ERR

Se levanta si este nodo es de un tipo que no permite hijos del tipo de uno de los nodes transmitidos, o si el nodo a insertar es uno de los ancestros de este nodo o este nodo mismo.

DOM_WRONG_DOCUMENT_ERR

Se levanta si uno de los nodes transmitidos ha sido creado a partir de un documento diferente del que creó este nodo.

Historial de cambios

Versión Descripción
8.3.0 Llamar a este método en un nodo sin documento propietario funciona ahora. Anteriormente, esto desencadenaba una DOMException con el código DOM_HIERARCHY_REQUEST_ERR.

Ejemplos

Ejemplo #1 Ejemplo de DOMElement::prepend()

Añade los nodos antes del elemento contenedor.

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

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

echo
$doc->saveXML();
?>

El ejemplo anterior mostrará :

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

Ver también

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top