xml_set_character_data_handler
(PHP 4, PHP 5, PHP 7)
xml_set_character_data_handler — Set up character data handler
Description
xml_set_character_data_handler ( XMLParser $parser , callable $handler ) : bool
Sets the character data handler function for the XML parser parser
.
Parameters
-
parser
-
A reference to the XML parser to set up character data handler function.
-
handler
-
handler
is a string containing the name of a function that must exist when xml_parse() is called forparser
.The function named by
handler
must accept two parameters:handler ( XMLParser $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.
Changelog
Version | Description |
---|---|
8.0.0 | parser expects an XMLParser instance now; previously, a resource was expected. |
© 1997–2020 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/function.xml-set-character-data-handler.php