Edit Report a Bug

DOMDocument::prepend

(PHP 8)

DOMDocument::prepend — Prepends nodes before the first child node

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

Prepends one or many nodes to the list of children before the first child node.

nodes: The nodes to prepend. Strings are automatically converted to text nodes.

Es wird kein Wert zurückgegeben.

DOM_HIERARCHY_REQUEST_ERR: Wird ausgelöst, wenn dieser Knoten von einem Typ ist, der keine Kinder vom Typ eines der übergebenen nodes zulässt, oder wenn der einzufügende Knoten einer der Vorfahren dieses Knotens oder dieser Knoten selbst ist.
DOM_WRONG_DOCUMENT_ERR: Wird ausgelöst, wenn einer der übergebenen nodes aus einem anderen Dokument erstellt wurde als dem, das diesen Knoten erstellt hat.

Version	Beschreibung
8.3.0	Calling this method on a node without an owner document now works. Zuvor führte dies zu einer DOMException mit dem Code `DOM_HIERARCHY_REQUEST_ERR`.

Beispiel #1 DOMDocument::prepend() example

Adds nodes before the document root.

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

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

echo $doc->saveXML();
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

There are no user contributed notes for this page.