PHP Conference Japan 2024

DOMCharacterData::replaceWith

(PHP 8)

DOMCharacterData::replaceWith以新的節點取代字元資料

說明

public DOMCharacterData::replaceWith(DOMNode|string ...$nodes): void

以新的 nodes 取代字元資料。

參數

nodes

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

回傳值

不回傳任何值。

錯誤/例外

DOM_HIERARCHY_REQUEST_ERR

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

DOM_WRONG_DOCUMENT_ERR

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

更新日誌

版本 說明
8.3.0 為了與 DOM 規範的行為一致,現在在沒有父節點的節點上呼叫此方法將不會執行任何操作。先前這會拋出代碼為 DOM_HIERARCHY_REQUEST_ERRDOMException

範例

範例 #1 DOMCharacterData::replaceWith() 範例

使用新的節點取代字元數據。

<?php
$doc
= new DOMDocument;
$doc->loadXML("<container><![CDATA[hello]]></container>");
$cdata = $doc->documentElement->firstChild;

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

echo
$doc->saveXML();
?>

上述範例將輸出

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

另請參閱

新增註釋

使用者貢獻的註釋

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