Edit Report a Bug

    DOMDocumentFragment::prepend

    (PHP 8)

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

    Beschreibung

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

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

    Parameter-Liste

    nodes

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

    Rückgabewerte

    Es wird kein Wert zurückgegeben.

    Fehler/Exceptions

    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.

    Changelog

    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.

    Beispiele

    Beispiel #1 DOMDocumentFragment::prepend() example

    Prepends nodes before the fragment root.

    <?php
    $doc     = new DOMDocument;
    $fragment = $doc->createDocumentFragment();
    $fragment->appendChild($doc->createElement("world"));

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

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

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    <hello/>beautiful<world/>

    Siehe auch

    add a note add a note

    User Contributed Notes

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