xml_set_processing_instruction_handler

(PHP 4, PHP 5)

xml_set_processing_instruction_handler — Imposta il gestore delle istruzioni di processo (PI)

Descrizione

bool xml_set_processing_instruction_handler ( resource $parser , callable $handler )

Imposta la funzione del gestore delle istruzioni di processo (PI) per il parser XML parser.

Un'istruzione di elaborazione ha il seguente formato:

<?

target data

?>

Si può inserire codice PHP all'interno di questo tipo di tag, ma occorre fare attenzione ad una limitazione: in una PI XML, il tag di fine PI (?>) non può essere tra apici, pertanto questa sequenza di caratteri non dovrebbe apparire nel codice PHP che si inserisce nel documento XML con le PI.Se ciò accade il resto del codice PHP, come il "reale" tag di fine PI, sarà trattato come dati di caratteri.

Elenco dei parametri

parser

Un riferimento al parser XML per impostare la funzione del gestore delle istruzioni di processo (PI).

handler

handler è una stringa contenente il nome di una funzione che deve esistere quando xml_parse() è chiamata per il parser.

La funzione indicata da handler deve accettare tre parametri:

handler ( resource $parser , string $target , string $data )

parser: Il primo parametro, parser, è un riferimento al parser XML che chiama il gestore.
target: Il secondo parametro, target, contiene l'obiettivo del PI.
data: Il terzo parametro, data, contiene i dati PI.

Se una funzione di gestione è impostata con una stringa vuota, oppure FALSE, il gestore in questione è disabilitato.

Nota: Invece di un nome di funzione, può essere passato anche un array contenente un riferimento ad oggetto e un nome di metodo.

Valori restituiti

Restituisce TRUE in caso di successo, FALSE in caso di fallimento.