xml_set_notation_decl_handler
(PHP 4, PHP 5)
xml_set_notation_decl_handler — Valorizza il gestore delle dichiarazione delle notazioni
Descrizione
Indica al parser XML parser la funzione per la gestione delle dichiarazioni delle notazioni. Il gestore è una stringa contenente il nome di una funzione che deve esistere quando viene eseguita la funzione xml_parse() per il parser .
La dichiarazione di una notazione è una parte della DTD del documento ed ha il seguente formato:
<!NOTATION <parameter>name</parameter> { <parameter>system_id</parameter> | <parameter>public_id</parameter>?>
La funzione indicata da gestore deve accettare cinque parametri:
- parser
- Il primo parametro, parser, è il riferimento al parser XML chiamante il gestore.
- nome_notazione
- Questo è il parametro name della notazione, come dal formato descritto in precedenza.
- base
- Questa è la base per la risoluzione dell'identificatore system (system_id ) delle entità esterne. Attualmente questo parametro è sempre valorizzato con una stringa vuota.
- system_id
- Identificatore system della dichiarazione della notazione esterna.
- public_id
- Identificatore public della dichiarazione della notazione esterna.
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.