xml_set_notation_decl_handler

(PHP 3>= 3.0.6, PHP 4 , PHP 5)

xml_set_notation_decl_handler -- Configure le gestionnaire XML de notations

Description

bool xml_set_notation_decl_handler ( resource parser, callback handler )

xml_set_notation_decl_handler() affecte les gestionnaires de début et de fin 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.

Une notation est une partie du DTD du document, qui a le format suivant :
<!NOTATION <parameter>name</parameter>
{ <parameter>systemid</parameter> | <parameter>publicid</parameter>?>
Reportez-vous à la section des spécifications XML 1.0 pour connaître les notations des entités externes.

La fonction handler doit accepter cinq paramètres : handler ( resource parser, string notation_name, string base, string system_id, string public_id )

parser

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

notation_name

Le nom de la notation,name, comme précisé dans le format de notation ci-dessus.

base

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

system_id

Identifiant système pour cet entité externe.

public_id

Identifiant public pour cet entité externe.

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

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

Note : A la place d'un nom de fonction, un tableau contenant une référence d'objet et un nom de méthode peut aussi être utilisé.