CommonMark\Node::insertBefore()

在指定节点之前插入一个子节点

首字母：C

函数名称：insertBefore()

函数描述：该函数用于在指定节点之前插入一个子节点。

适用版本：该函数从PHP 7.3.0版本开始可用。

语法：public CommonMark\Node::insertBefore(CommonMark\Node $newNode, CommonMark\Node $refNode = null): void

参数：

$newNode：要插入的新节点。
$refNode（可选）：参考节点，新节点将在其前插入。如果未提供参考节点，则新节点将被插入为第一个子节点。

返回值：该函数没有返回值。

示例：

// 创建一个Markdown解析器实例
$parser = new CommonMark\Parser();
// 解析Markdown文本为AST（抽象语法树）
$document = $parser->parse('# Hello, World!');
// 创建一个新的段落节点
$paragraph = new CommonMark\Block\Element\Paragraph();
// 在文档的第一个子节点之前插入新的段落节点
$document->insertBefore($paragraph, $document->firstChild());
// 将新的段落节点转换为HTML字符串
$html = $document->render();
echo $html;

输出：


Hello, World!

以上示例中，我们首先创建了一个新的Markdown解析器实例。然后，我们使用解析器将Markdown文本解析为AST（抽象语法树）表示形式。接下来，我们创建了一个新的段落节点。最后，我们使用insertBefore()函数将新的段落节点插入到文档的第一个子节点之前，并最终将整个文档转换为HTML字符串进行输出。

Hello, World!

同首字母函数