xml_set_element_handler
(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.