PHP 8.5.0 Alpha 1 available for testing

DOMDocumentFragment::replaceChildren

(PHP 8 >= 8.3.0)

DOMDocumentFragment::replaceChildrenReemplaza los hijos en el fragmento

Descripción

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

Reemplaza los hijos en el fragmento por nuevos nodes.

Parámetros

nodes

Los nodos que reemplazan a los hijos. 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 DOMDocumentFragment::replaceChildren()

Reemplaza los hijos por nuevos nodos.

<?php
$doc
= new DOMDocument;
$doc->loadXML("<container><hello/></container>");
$fragment = $doc->createDocumentFragment();
$fragment->append("hello");

$fragment->replaceChildren("beautiful", $doc->createElement("world"));

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

El ejemplo anterior mostrará :

beautiful
<world/>

Ver también

add a note

User Contributed Notes

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