(PHP 8)
DOMCharacterData::before — 在節點前新增節點
nodes要在該節點前新增的節點。字串會自動轉換為文字節點。
不傳回任何值。
DOM_HIERARCHY_REQUEST_ERR如果父節點的類型不允許其中一個傳入的 nodes 節點的類型作為子節點，或者要插入的節點是此節點的祖先或此節點本身，則會引發此例外。
DOM_WRONG_DOCUMENT_ERR如果其中一個傳入的 nodes 節點是從與建立此節點不同的文件建立的，則會引發此例外。
| 版本 | 說明 |
|---|---|
| 8.3.0 | 為了與 DOM 規範的行為一致，在沒有父節點的節點上呼叫此方法現在是無操作。 以前，這會引發一個程式碼為 DOM_HIERARCHY_REQUEST_ERR 的 DOMException 例外。 |
範例 #1 DOMCharacterData::before() 範例
在字元數據之前新增節點。
<?php
$doc = new DOMDocument;
$doc->loadXML("<container><![CDATA[world]]></container>");
$cdata = $doc->documentElement->firstChild;
$cdata->before("hello", $doc->createElement("beautiful"));
echo $doc->saveXML();
?>上述範例將輸出
<?xml version="1.0"?> <container>hello<beautiful/><![CDATA[world]]></container>