xml_set_element_handler
(PHP 4, PHP 5)
xml_set_element_handler — Valorizza i gestori di inizio e fine elemento
Descrizione
La funzione indica le funzioni di gestione di inizio e fine elemento per il parser XML. gestore_inizio_elemento e gestore_fine_elemento sono stringhe contenenti i nomi di funzioni che devono esistere quando viene eseguito xml_parse() per il parser .
La funzione indicata da gestore_inizio_elemento deve accettare tre parametri:
- parser
- Il primo parametro, parser, è il riferimento al parser XML chiamante il gestore.
- nome
- Il secondo parametro, nome , contiene il nome dell'elemento per il quale viene chiamato il gestore. Se è attivo il case-folding per questo parser, il nome dell'elemento sarà in maiuscolo.
- attributi
- Il terzo parametro, attributi , contiene un array associativo con gli attributi dell'elemento (se presenti). Le chiavi di questo array sono i nomi degli attributi, mentre i valori delle chiavi sono i valori degli attributi. I nomi degli attributi sono case-folded allo stesso modo dei nomi degli elementi. I valori degli attributi non lo sono. L'ordine originale degli attributi può essere recuperato attraversando attributi in modo normale utilizzando la funzione each(). La prima chiave dell'array è il primo attributo, e così via.
La funzione indicata da gestore_fine_elemento deve accettare due parametri:
- parser
- Il primo parametro, parser, è il riferimento al parser XML chiamante il gestore.
- nome
- Il secondo parametro, nome , contiene il nome dell'elemento per il quale viene chiamato il gestore. Se è attivo il case-folding per questo parser, il nome dell'elemento sarà in maiuscolo.
Se il nome della funzione del gestore viene valorizzato con una stringa vuota oppure a FALSE, il gestore in questione viene disabilitato.
La funzione restituisce TRUE se il gestore viene attivato, FALSE se parser non indica un parser XML.
Nota: Invece di un nome di funzione, può essere passato anche un array contenente un riferimento ad oggetto e un nome di metodo.