DOMNode::replaceChild
子を置き換える
&reftitle.description;
public DOMNodefalseDOMNode::replaceChild
DOMNodenode
DOMNodechild
この関数は、子要素 child を新しいノードに
置き換えます。もし node がすでに子要素であった場合は、
それがふたたび追加されることはありません。置き換えに成功すると、
置き換え前のノードが返されます。
&reftitle.parameters;
node
新しいノード。対象ドキュメントのメンバ、
すなわち、DOMDocument->createXXX() メソッドのひとつで作成されたものか
で
ドキュメントにインポートされたものである必要があります。
child
古いノード。
&reftitle.returnvalues;
古いノード、あるいはエラーが発生した場合は &false; を返します。
&reftitle.errors;
以下のエラーコードで DOMException
をスローします:
DOM_NO_MODIFICATION_ALLOWED_ERR
このノードが読み込み専用であったり、挿入されるノードの以前の親が
読み込み専用であった場合に発生します。
DOM_HIERARCHY_REQUEST_ERR
node で指定した型の子ノードを
保持することが許可されていない場合、あるいは追加しようとしている
ノードが自分自身やその祖先であった場合に発生します。
DOM_WRONG_DOCUMENT_ERR
node が、このノードとは別の
ドキュメントで作成されたものである場合に発生します。
DOM_NOT_FOUND_ERR
child がこのノードの子でない場合に発生します。
&reftitle.seealso;
DOMChildNode::replaceWith
DOMNode::appendChild
DOMNode::removeChild