PHP 8.5.0 Alpha 1 available for testing

DOMParentNode::replaceChildren

(PHP 8 >= 8.3.0)

DOMParentNode::replaceChildrenReemplaza los hijos en un nodo

Descripción

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

Reemplaza los hijos en un nodo.

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 DOMParentNode::replaceChildren()

<?php

$dom
= new DOMDocument();
$dom->loadHTML('<!DOCTYPE HTML><html><p>hi</p> test <p>hi2</p></html>');

$dom->documentElement->replaceChildren('foo', $dom->createElement('p'), 'bar');
echo
$dom->saveXML();
?>

El ejemplo anterior mostrará :

<?xml version="1.0" standalone="yes"?>
<!DOCTYPE HTML>
<html>foo<p/>bar</html>
add a note

User Contributed Notes

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