Añade un nuevo hijo antes del nodo de referencia

Descripción

public DOMNode DOMNode::insertBefore ( DOMNode $newnode [, DOMNode $refnode ] )

Esta función inserta un nuevo nodo justo antes que el nodo de referencia. Si planea hacer modificaciones posteriores al hijo añadido debe usar el nodo devuelto.

Parámetros

newnode: El nuevo nodo.
refnode: El nodo de referencia. Si no se proporciona, newnode es añadido al hijo.

Valores devueltos

El nodo insertado.

Errores/Excepciones

DOM_NO_MODIFICATION_ALLOWED_ERR: Lanzado si este nodo es de sólo lectura o si el padre previo del nodo que va a ser insertado es de sólo lectura.
DOM_HIERARCHY_REQUEST_ERR: Lanzado si este nodo es de un tipo de no permite hijos del tipo del nodo newnode, o si el nodo a añadir es uno de los progenitores del nodo o si es el nodo en sí.
DOM_WRONG_DOCUMENT_ERR: Lanzado si newnode fue creado desde un documento diferente del que creó este nodo.
DOM_NOT_FOUND: Lanzado si refnode no es un hijo de este nodo.