xml_set_element_handler
(PHP 4, PHP 5)
xml_set_element_handler — Set up start and end element handlers
Описание
bool xml_set_element_handler
( resource $parser
, callback $start_element_handler
, callback $end_element_handler
)
Sets the element handler functions for the XML parser
.
start_element_handler
and
end_element_handler
are strings containing
the names of functions that must exist when xml_parse()
is called for parser
.
Список параметров
-
parser
-
-
start_element_handler
-
The function named by start_element_handler
must accept three parameters:
start_element_handler
( resource $parser
, string $name
, array $attribs
)
-
parser
-
The first parameter, parser, is a
reference to the XML parser calling the handler.
-
name
-
The second parameter, name
, contains the name
of the element for which this handler is called.If case-folding is in effect for this
parser, the element name will be in uppercase letters.
-
attribs
-
The third parameter, attribs
, contains an
associative array with the element's attributes (if any).The keys
of this array are the attribute names, the values are the attribute
values.Attribute names are case-folded on the same criteria as
element names.Attribute values are not
case-folded.
The original order of the attributes can be retrieved by walking
through attribs
the normal way, using
each().The first key in the array was the first
attribute, and so on.
Note: В качестве аргумента вместо имени
функции может быть передан массив, содержащий ссылку на объект
и имя метода.
-
end_element_handler
-
The function named by end_element_handler
must accept two parameters:
end_element_handler
( resource $parser
, string $name
)
-
parser
-
The first parameter, parser, is a
reference to the XML parser calling the handler.
-
name
-
The second parameter, name
, contains the name
of the element for which this handler is called.If case-folding is in effect for this
parser, the element name will be in uppercase letters.
If a handler function is set to an empty string, or FALSE, the handler
in question is disabled.
Возвращаемые значения
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.