DOMCharacterData::before

(PHP 8)

DOMCharacterData::before在节点之前添加节点

描述

public DOMCharacterData::before(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::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>

参见

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top