xml_set_element_handler
(PHP 4, PHP 5)
xml_set_element_handler — Valorizza i gestori di inizio e fine elemento
Descrizione
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, può
essere passato anche un array contenente un riferimento ad oggetto e un
nome di metodo.