DOMNode::removeChild
(PHP 5, PHP 7, PHP 8)
DOMNode::removeChild — Removes child from list of children
Description
This functions removes a child from a list of children.
Parameters
-
child
-
The removed child.
Return Values
If the child could be removed the function returns the old child.
Errors/Exceptions
-
DOM_NO_MODIFICATION_ALLOWED_ERR
-
Raised if this node is readonly.
-
DOM_NOT_FOUND
-
Raised if
child
is not a child of this node.
Examples
The following example will delete the chapter
element of our XML document.
Example #1 Removing a child
<?php
$doc = new DOMDocument;
$doc->load('book.xml');
$book = $doc->documentElement;
// we retrieve the chapter and remove it from the book
$chapter = $book->getElementsByTagName('chapter')->item(0);
$oldchapter = $book->removeChild($chapter);
echo $doc->saveXML();
?>
The above example will output:
<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> <book id="listing"> <title>My lists</title> </book>
See Also
- DOMChildNode::remove() - Removes the node
- DOMNode::appendChild() - Adds new child at the end of the children
- DOMNode::replaceChild() - Replaces a child