DomNode->replace_child

PHP関数リファレンス

DomNode->replace_child

(No version information available, might be only in CVS)
DomNode->replace_child — 子ノードを置換する

説明

domelement DomNode->replace_child ( domelement newnode, domelement oldnode )
(PHP 4.2) この関数は子ノード oldnode を渡された新規ノードに置換します。もし新規ノードがすでに子ノードの場合、 二度目は追加されません。もし古いノードが存在しない場合、 この関数は FALSE を返します。もし置換が成功した場合、 古いノードが返されます。
(PHP 4.3) この関数は新規ノードがすでに DomNode の子ノードだったとしても、 子ノード oldnode を渡された newnode に置換します。 もし newnode ガスでに文章に挿入されている場合、 最初に既存のコンテキストから削除されます。 もし古いノードが存在しない場合、この関数は FALSE を返し、 置換が成功した場合は古いノードが返されます (この動作は W3C 規格に準拠しています。)
domnode_append_child() も参照ください。

DOMNode->replaceChild()

(No version information available, 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()