xml_set_character_data_handler
(PHP 4, PHP 5)
xml_set_character_data_handler — Set up character data handler
Description
bool xml_set_character_data_handler
(
resource $parser
,
callback $handler
)
Parameters
-
parser
-
-
handler
-
handler
is a string containing the name of a
function that must exist when xml_parse() is called
for parser
.
The function named by handler
must accept
two parameters:
handler
( resource $parser
, string $data
)
-
parser
-
The first parameter, parser, is a
reference to the XML parser calling the handler.
-
data
-
The second parameter, data
, contains
the character data as a string.
Character data handler is called for every piece of a text in the XML
document. It can be called multiple times inside each fragment (e.g.
for non-ASCII strings).
If a handler function is set to an empty string, or FALSE, the handler
in question is disabled.
Note: Instead of a function name, an
array containing an object reference and a method name can also be
supplied.
Return Values
Returns TRUE on success or FALSE on failure.