Method replace_by

scene/main/node.cpp:3215–3280

}

void Node::replace_by(Node *p_node, bool p_keep_groups) {
	ERR_THREAD_GUARD
	ERR_FAIL_NULL(p_node);
	ERR_FAIL_COND(p_node->data.parent);

	List<Node *> owned = data.owned;
	List<Node *> owned_by_owner;
	Node *owner = (data.owner == this) ? p_node : data.owner;

	if (p_keep_groups) {
		List<GroupInfo> groups;
		get_groups(&groups);

		for (const GroupInfo &E : groups) {
			p_node->add_to_group(E.name, E.persistent);
		}
	}

	_replace_connections_target(p_node);

	if (data.owner) {
		for (int i = 0; i < get_child_count(); i++) {
			find_owned_by(data.owner, get_child(i), &owned_by_owner);
		}

		_clean_up_owner();
	}

	Node *parent = data.parent;
	int index_in_parent = get_index(false);

	if (data.parent) {
		parent->remove_child(this);
		parent->add_child(p_node);
		parent->move_child(p_node, index_in_parent);
	}

	emit_signal(SNAME("replacing_by"), p_node);

	while (get_child_count()) {
		Node *child = get_child(0);
		remove_child(child);
		if (!child->is_internal()) {
			// Add the custom children to the p_node.
			Node *child_owner = child->get_owner() == this ? p_node : child->get_owner();
			child->set_owner(nullptr);
			p_node->add_child(child);
			child->set_owner(child_owner);
		}
	}

	p_node->set_owner(owner);
	for (Node *E : owned) {
		if (E->data.owner != p_node) {
			E->set_owner(p_node);
		}
	}