子要素群の最後に新しい子要素を追加する

# DOMNode::appendChild

(PHP 5, PHP 7, PHP 8)

DOMNode::appendChild — 子要素群の最後に新しい子要素を追加する

### 説明

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

この関数は、既存の子要素のリストに新しい子要素を追加するか、 あるいは新しい子要素リストを作成します。子要素の作成には DOMDocument::createElement()、 DOMDocument::createTextNode() などを使用するか、単に別のノードを使用します。

既存のノードを使う場合、そのノードは移動します。

### パラメータ

`node`

  追加する子要素。

### 戻り値

追加したノードを返します。 エラーの場合は `false` を返します。

### エラー / 例外

以下のエラーコードで DOMException をスローします:

`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() - 子を置き換える

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open