PHP マニュアル: 子要素群の最後に新しい子要素を追加する

説明

public DOMNodefalse DOMNode::appendChild(DOMNode $node)

この関数は、既存の子要素のリストに新しい子要素を追加するか、あるいは新しい子要素リストを作成します。子要素の作成には 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();
?>

参考

DOMChildNode::after
DOMNode::insertBefore
DOMNode::removeChild
DOMNode::replaceChild