xml_set_element_handler
(PHP 3 >= 3.0.6, PHP 4, PHP 5)
xml_set_element_handler -- Valorizza i gestori di inizio e fine elementoDescrizione
bool xml_set_element_handler ( resource parser, callback gestore_inizio_elemento, callback gestore_fine_elemento )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:
gestore ( resource parser, string nome, array attibuti )
- 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:
gestore ( resource parser, string nome )
- 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 è possibile passare un vettore contenente un riferimento ad un oggetto e un nome di metodo.