2024 日本 PHP 研討會

DOMDocumentFragment::replaceChildren

(PHP 8 >= 8.3.0)

DOMDocumentFragment::replaceChildren取代片段中的子節點

說明

public DOMDocumentFragment::replaceChildren(DOMNode|字串 ...$nodes): void

使用新的 nodes 節點取代文件片段中的子節點。

參數

nodes (節點)

用於取代子節點的節點。字串會自動轉換為文字節點。

返回值

不返回任何值。

錯誤/異常

DOM_HIERARCHY_REQUEST_ERR

如果此節點的類型不允許傳入的 nodes 參數中某個節點的類型作為子節點,或者如果要放入的節點是此節點的祖先節點或此節點本身,則會引發此錯誤。

DOM_WRONG_DOCUMENT_ERR

如果傳入的 nodes 參數中某個節點是從與創建此節點不同的文件創建的,則會引發此錯誤。

更新日誌

版本 說明
8.3.0 現在可以在沒有所有者文件的節點上調用此方法。以前,這會引發代碼為 DOM_HIERARCHY_REQUEST_ERRDOMException 異常。

範例

範例 #1 DOMDocumentFragment::replaceChildren() 範例

使用新的節點取代子節點。

<?php
$doc
= new DOMDocument;
$doc->loadXML("<container><hello/></container>");
$fragment = $doc->createDocumentFragment();
$fragment->append("hello");

$fragment->replaceWith("beautiful", $doc->createElement("world"));

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

以上範例會輸出:

beautiful
<world/>

參見

新增註解

使用者提供的註解

此頁面沒有使用者提供的註解。
To Top