Forum und email

DOMNode->replaceChild()

(No version information available, might be only in CVS)

DOMNode->replaceChild() — Sostituisce un nodo figlio

Descrizione

DOMNode
DOMNode replaceChild ( DOMNode $newnode , DOMNode $oldnode )

Questa funzione sostituisce il nodo figlio oldnode con il nuovo nodo fornito. Se il nuovo nodo è già un nodo figlio, questo non verrà inserito una seconda volta. Se la sostituzione ha avuto successo, la funzione restituisce il vecchio nodo.

Elenco dei parametri

newnode

Il nuovo nodo. Deve essere membro del docuemnto di destinazione, ad esempio creato da uno dei metodi DOMDocument->createXXX() oppure importato nel documento con DOMDocument->importNode().

oldnode

Il vecchio nodo.

Valori restituiti

Il vecchio nodo oppure FALSE in caso di errore.

Eccezioni

DOM_NO_MODIFICATION_ALLOWED_ERR

Generato se questo nodo è in sola lettura oppure se il precdente padre del nodo da inserire è in sola lettura.

DOM_HIERARCHY_REQUEST_ERR

Generato se il nodo è di un tipo che non ammette nodi figli del tipo di newnode , oppure se il nodo da inserire è uno dei padri del nodo, oppure se è il nodo stesso.

DOM_WRONG_DOCUMENT_ERR

Generato se newnode è stato creato in un docuemnto differente rispetto al documento in cui è stato creato il nodo.

DOM_NOT_FOUND

Generato se oldnode non è figlio del nodo.