xml_set_external_entity_ref_handler

xml_set_external_entity_ref_handler -- Modifie le gestionnaire de référence externes.

Description

int xml_set_external_entity_ref_handler ( resource parser, string handler)

Fixe le gestionnaire d' entité externe de l'analyseur XML parser . handler et endElementHandler sont des chaînes qui contiennent les noms de fonction qui existent lorsque xml_parse( ) est appelé pour créer le parser .

La fonction handler La fonction handler doit accepter 5 paramètres , et retourner un entier . Si la valeur retourné par le gestionnaire est FALSE ( comme par exemple si aucune valeur n'est retournée) , l'analyseur XML s'arrêtera , et la fonction xml_get_error_code( ) retournera XML_ERROR_EXTERNAL_ENTITY_HANDLING . int handler ( resource parser , string openEntityNames , string base , string systemId , string publicId )

parser

Le premier paramètre , parser , est une référence sur l ' analyseur XML qui appelle cette fonction .

openEntityNames

Le deuxième paramètre , openEntityNames , est la liste de noms d ' entité , séparés par des espaces . Ces entités sont accessibles à l' analyse par cet entité (y compris le nom de l'entité reférencé ) .

base

La meilleure base de résolution de l ' identifiant système de cet entité externe . Actuellement , ce paramètre est toujours une chaîne vide .

systemId

Identifiant système pour cet entité externe .

publicId

Le cinquième paramètre , publicId , est l' identifiant public , comme spécifié dans la déclaration d'entité , ou un chaîne vide , si aucune déclaration n 'a été spécifiée . L' espace dans l 'identifiant public sera normalisé comme spécifié dans les spécifications XML .



Si un gestionnaire reçoit une chaîne vide , ou FALSE , c' est qu'il est en train d 'être désactivé .

xml_set_external_entity_ref_handler( ) retourne TRUE si le gestionnaire est actif , et FALSE sinon ou si parser n 'est pas un analyseur .

Il n' est pas pour l'instant possible d 'utiliser des objets pour servir de gestionnaire . Reportez-vous à xml_set_object( ) pour utiliser l 'analyseur XML depuis un objet .