(PHP 3 >= 3.0.6, PHP 4, PHP 5)
xml_set_element_handler -- establece gestores de los elementos principio y fin
Descripción
int
xml_set_element_handler ( int parser, string startElementHandler, string endElementHandler )
Establece las funciones de gestion de elementos para el analizador XML
parser.
startElementHandler y
endElementHandler son strings que contienen
los nombres de las funciones que deben existir cuando
xml_parse() es llamado por
parser.
La función denominada startElementHandler
debe aceptar tres parámetros:
startElementHandler ( int parser, string name, string attribs )
- parser
El primer parámetro, parser, es una
referencia al analizador XML que llama al gestor.
- name
El segundo parámetro, name, contiene
el nombre del elemento para el que se llama a este gestor. Si la
propiedad de
case-folding
tiene efecto para este analizador, el nombre del elemento
estará en mayúsculas.
- attribs
El tercer parámetro, attribs, contiene
un array asociativo con los atributos de los elementos (si hay).
Las claves de este array son los nombres de los atributos, los
valores son los valores de los atributos. Los nombres de los
atributos están en mayúsculas (case-folded) con el mismo criterio
que los nombres de los elementos. Los valores de los atributos
no sufren las consecuencias de case-folding.
El orden original de los atributos se puede recuperar recorriendo
attribs del modo usual, usando
each(). La primera clave del array es el
el primer atributo, y asà sucesivamente.
La función llamada endElementHandler
debe aceptar dos parámetros:
endElementHandler ( int parser, string name )
- parser
El primer parámetro, parser, es una
referencia al analizador XML que llama al gestor.
- name
El segundo parámetro, name, contiene
el nombre del elemento para el que se llama a este gestor. Si la
propiedad de
case-folding
tiene efecto para este analizador, el nombre del elemento
estará en mayúsculas.
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 establecieron los gestores, FALSE si
parser no es un analizador.
En la actualidad no hay soporte para gestores objeto/método.
