xml_set_unparsed_entity_decl_handler

(PHP 3>= 3.0.6, PHP 4 , PHP 5)

xml_set_unparsed_entity_decl_handler --  Valorizza il gestore delle dichiarazioni di entitÓ non analizzate

Descrizione

bool xml_set_unparsed_entity_decl_handler ( resource parser, callback gestore)

Indica al parser XML parser la funzione per la gestione delle dichiarazioni di entitÓ non analizzate. Il gestore Ŕ una stringa contenente il nome di una funzione che deve esistere quando viene eseguita la funzione xml_parse() per il parser.

Questo gestore viene richiamato quando il parser XML incontra una dichiarazione di entitÓ esterna con una dichiarazione NDATA, tipo la seguente:
<!ENTITY <parameter>name</parameter> {<parameter>publicId</parameter> | <parameter>systemId</parameter>} 
        NDATA <parameter>notationName</parameter>

Vedere la sezione 4.2.2 delle specifiche di XML 1.0 per la definizione di notazioni dichiarate in entitÓ esterne.

La funzione indicata da gestore deve accettare sei parametri: gestore ( resource parser, string nome_entitÓ, string base, string system_id, string public_id, string nome_notazione)

parser

Il primo parametro, parser, Ŕ il riferimento al parser XML chiamante il gestore.

nome_entitÓ

Il nome dell'entitÓ che sta per essere definita.

base

Questa Ŕ la base per la risoluzione dell'identificatore system (systemid) delle entitÓ esterne. Attualmente questo parametro Ŕ sempre valorizzato con una stringa vuota.

system_id

Identificatore system per l'entitÓ esterna.

public_id

Identificatore public per l'entitÓ esterna.

nome_notazione

Nome della notazione di questa entitÓ (vedere xml_set_notation_decl_handler()).

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.