PHP 8.5.0 Alpha 2 available for testing

DOMDocument::prepend

(PHP 8)

DOMDocument::prependAñade nodos antes del primer nodo hijo

Descripción

public DOMDocument::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 DOMDocument::prepend()

Añade nodos antes del nodo raíz del documento.

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

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

echo
$doc->saveXML();
?>

El ejemplo anterior mostrará :

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

Ver también

add a note

User Contributed Notes

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