PHP Conference Japan 2024

DOMElement::prepend

(PHP 8)

DOMElement::prepend將節點插入至第一個子節點之前

描述

public DOMElement::prepend(DOMNode|字串 ...$nodes): void

將一個或多個 nodes 插入到第一個子節點之前的子節點列表中。

參數

nodes

要插入的節點。字串會自動轉換為文字節點。

回傳值

不回傳任何值。

錯誤/例外

DOM_HIERARCHY_REQUEST_ERR

如果此節點的類型不允許傳遞的 nodes 之一的類型子節點,或如果放入的節點是此節點的祖先或此節點本身,則會引發此錯誤。

DOM_WRONG_DOCUMENT_ERR

如果傳遞的 nodes 之一是由與建立此節點不同的文件建立的,則會引發此錯誤。

變更記錄

版本 描述
8.3.0 現在可以對沒有所有者文件的節點呼叫此方法。先前這會拋出程式碼為 DOM_HIERARCHY_REQUEST_ERRDOMException

範例

範例 #1 DOMElement::prepend() 範例

將節點插入到容器元素中。

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

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

echo
$doc->saveXML();
?>

上述範例會輸出

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

另請參閱

新增附註

使用者貢獻的附註

此頁面沒有使用者貢獻的附註。
To Top