xml_set_external_entity_ref_handler

xml_set_external_entity_ref_handler -- Establece gestores de referencia de entidades externas

Descripción

int xml_set_external_entity_ref_handler ( int parser, string handler)

Establece la función gestora de declaraciones de notación para el analizador XML parser . handler es un string que contiene el nombre de una función que debe existir cuando xml_parse( ) es llamado por parser .

La función llamada por handler debe aceptar cinco parámetros , y debería devolver un valor entero . Si el valor devuelto desde el gestor ( handler ) es falso (lo cual ocurrirá si no se devuelve un valor) , el analizador XML dejará de analizar y xml_get_error_code( ) devolverá XML_ERROR_EXTERNAL_ENTITY_HANDLING . int handler ( int parser , string openEntityNames , string base , string systemId , string publicId )

parser

El primer parámetro , parser , es una referencia al analizador XML que llama al gestor .

openEntityNames

El segundo parámetro , openEntityNames , es una lista , separada por espacios , de los nombres de las entidades que se abren para el análisis de esta entidad ( incluido el nombre de la entidad referenciada ) .

base

Esta es la base para resolver el identificador de sistema ( systemid ) de la entidad externa . En la actualidad este parámetro es siempre la cadena vacía .

systemId

El cuarto parámetro , systemId , es el identificador del sistema tal como se especificó en la declaración de la entidad .

publicId

El quinto parámetro , publicId , es el identificador público como se especificó en la declaración de la entidad , o una cadena vacía si no se especificó ninguno ; el espacio en blanco en el identificador público se habrá normalizado como se requiere en las especificaciones XML .



Si una función gestora se establece como la cadena vacía , o FALSE , el gestor en cuestión se deshabilita .

Se devuelve TRUE si se estableció el gestor , FALSE si parser no es un analizador .

En la actualidad no hay soporte para gestores objeto / método .