Manuale PHP
Indietro |  | Avanti

# 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.

Indietro | Partenza | Avanti
xml_set_start_namespace_decl_handler | Risali | Funzioni XML-RPC