DOMNode::appendChild

(PHP 5, PHP 7, PHP 8)

DOMNode::appendChild — Добавляет новый дочерний узел в конец списка потомков

Описание

public DOMNode::appendChild(DOMNode $node): DOMNode|false

Функция добавляет дочерний узел в существующий список потомков или создаёт новый список дочерних элементов. Дочерний узел может быть создан с помощью DOMDocument::createElement(), DOMDocument::createTextNode() и т.д., или может быть использован любой другой узел.

При использовании существующего узла он будет перемещён.

Список параметров

node

Добавляемый дочерний узел.

Возвращаемые значения

Возвращает добавленный узел или false в случае возникновения ошибки.

Ошибки

DOM_NO_MODIFICATION_ALLOWED_ERR

Возникает, если узел доступен только для чтения или предыдущий родитель вставляемого узла доступен только для чтения.

DOM_HIERARCHY_REQUEST_ERR

Возникает, если тип узла не поддерживает потомков типа, который имеет узел node, или если добавляемый узел является одним из предком целевого узла или им самим.

DOM_WRONG_DOCUMENT_ERR

Возникает, если node создан в другом документе, отличном от того, в котором был создан этот узел.

Примеры

Следующий пример добавляет новый узел в только что созданный документ.

Пример #1 Добавление дочернего узла

<?php

$doc = new DOMDocument;

$node = $doc->createElement("para");
$newnode = $doc->appendChild($node);

echo $doc->saveXML();
?>

Пример #2 Вложенные дочерние узлы

<?php

$doc = new DOMDocument;

$headNode = $doc->createElement("head");
$doc->appendChild($headNode);

$titleNode = $doc->createElement("title");
$headNode->appendChild($titleNode);

echo $doc->saveXML();
?>

Смотрите также