DOM DOMNode::replaceChild
(PHP 5, PHP 7, PHP 8)
DOMNode::replaceChild — 자식 대체
설명
public DOMNode::replaceChild(DOMNode $node
, DOMNode $child
): DOMNode|false
이 함수는 자식 child
을 전달된 새 노드로 바꿉니다. node
가 이미 자식인 경우 두 번째로 추가되지 않습니다. 교체가 성공하면 이전 노드가 반환됩니다.
매개변수
node
- 새 노드. 이는 대상 문서의 구성원이어야 합니다. 즉, DOMDocument->createXXX() 메서드 중 하나에 의해 생성되거나 DOMDocument::importNode에 의해 문서에서 가져온 것입니다.
child
- 오래된 노드.
반환 값
이전 노드이거나 오류가 발생하면 false
입니다.
오류/예외
DOM_NO_MODIFICATION_ALLOWED_ERR
- 이 노드가 읽기 전용이거나 삽입되는 노드의 이전 부모가 읽기 전용이면 발생합니다.
DOM_HIERARCHY_REQUEST_ERR
- 이 노드가
node
노드 유형의 자식을 허용하지 않는 유형이거나 추가할 노드가 이 노드의 조상 중 하나이거나 이 노드 자체인 경우 발생합니다. DOM_WRONG_DOCUMENT_ERR
node
가 이 노드를 만든 문서와 다른 문서에서 만든 경우 발생합니다.DOM_NOT_FOUND
child
이 이 노드의 자식이 아니면 발생합니다.
기타
- DOMChildNode::replaceWith() - 노드를 새 노드로 교체
- DOMNode::appendChild() - 자식의 끝에 새 자식을 추가합니다.
- DOMNode::removeChild() - 자식 목록에서 자식 제거