DOMDocument

AdoptNode

Sintaxis:

AdoptNode()

Valor devuelto:

Tipo: DOMDocument, Undefined.
Nodo adaptado o Undefined si la adaptación falló.

Descripción:

Proporciona la adaptación (adopción) de un nodo de otro documento. Intenta adoptar un nodo de otro documento.
Si la adaptación es compatible para el nodo, se realiza una sustitución recursiva del documento propietario en este nodo, todos sus nodos hijos y atributos.
Si el nodo tiene un nodo padre, primero se elimina del nodo padre.
Reglas de adaptación para tipos de nodos:
Atributo – Documento se establece en Undefined, propiedad Specified se establece en True;
Fragmento de documento – todos los hijos de un nodo de fragmento se adaptan de forma recursiva;
Documento – no se puede adaptar;
Tipo de documento – no se puede adaptar;
Elemento – se adaptan los atributos con la propiedad Specified establecida, para un nuevo nodo-elemento se crean atributos con valores predeterminados. Todos los hijos se adaptan de forma recursiva;
Entidad – no se puede adaptar;
Referencia de entidad – solo se adapta este nodo. Si se define una entidad con el mismo nombre en este documento, se forma un valor de entidad para la referencia adaptada;
Notación – no se puede adaptar;
Instrucción de procesamiento, Texto, Sección CDATA, Comentario – adaptados.

Disponibilidad:

Servidor, cliente grueso, conexión externa, aplicación móvil (servidor), servidor independiente móvil.

Nota:

Razones de llamada de excepción:

• Intento de adaptación de nodo Documento, Tipo de documento;
• El documento actual del nodo adaptado está en modo de solo lectura.

Disponible desde:

Disponible desde la versión 8.1.