DOMNode->replaceChild()

(no version information, might be only in CVS)

DOMNode->replaceChild() --  子を置き換える

説明

class DOMNode {

DOMNode replaceChild ( DOMNode newnode, DOMNode oldnode )

}

この関数は、子要素 oldnode を新しいノードに 置き換えます。もし新しいノードがすでに子要素であった場合は、 それがふたたび追加されることはありません。置き換えに成功すると、 置き換え前のノードが返されます。

パラメータ

newnode

新しいノード。対象ドキュメントのメンバ、 すなわち、DOMDocument->createXXX() メソッドのひとつで作成されたものか DOMDocument->importNode() で ドキュメントにインポートされたものである必要があります。

oldnode

古いノード。

返り値

古いノード、あるいはエラーが発生した場合は FALSE を返します。

例外

DOM_NO_MODIFICATION_ALLOWED_ERR

このノードが読み込み専用であったり、挿入されるノードの以前の親が 読み込み専用であった場合に発生します。

DOM_HIERARCHY_REQUEST_ERR

newnode で指定した型の子ノードを 保持することが許可されていない場合、あるいは追加しようとしている ノードが自分自身やその祖先であった場合に発生します。

DOM_WRONG_DOCUMENT_ERR

newnode が、このノードとは別の ドキュメントで作成されたものである場合に発生します。

DOM_NOT_FOUND

oldnode がこのノードの子でない場合に 発生します。

参考

DOMNode->appendChild()
DOMNode->removeChild()