Manuel PHP
Précédent |  | Suivant

# xml_set_unparsed_entity_decl_handler

(PHP 3>= 3.0.6, PHP 4 )

xml_set_unparsed_entity_decl_handler -- Affecte les gestionnaires d'entité non déclaré.

## Description

int xml_set_unparsed_entity_decl_handler ( resource parser, string handler)

Affecte les gestionnaires d'entité non déclaré de l'analyseur XML `parser`. `handler` est une chaîne qui contient le nom d'une fonction qui existe lorsque xml_parse() est appelé pour créer `parser`.

Ce gestionnaire sera appelé si l'analyseur XML rencontre une déclaration d'entité externe avec une déclaration de NDATA, comme suit :

    <!ENTITY name {publicId | systemId}
            NDATA notationName

Reportez-vous à la section des spécifications XML 1.0 pour connaître les notations des entités externes.

La fonction `handler` doit accepter six paramètres: `handler` ( resource parser, string entityName, string base, string systemId, string publicId, string notationName)

`parser`

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

`entityName`

  Le nom de l'entité qui va être définie

`base`

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

`systemId`

  Identifiant système pour cet entité externe.

`publicId`

  Identifiant public pour cet entité externe.

`notationName`

  Nom de la notation de cette entité. (Voir xml_set_notation_decl_handler()).

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

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

Précédent | Sommaire | Suivant
xml_set_start_namespace_decl_handler | Niveau supérieur | XMLRPC