php man page for xml_set_character_data_handler

XML_SET_CHARACTER_DATA_HANDLER(3)					 1					 XML_SET_CHARACTER_DATA_HANDLER(3)

xml_set_character_data_handler - Set up character data handler

SYNOPSIS
       bool xml_set_character_data_handler (resource  $parser, callable  $handler)

DESCRIPTION
	Sets the character data handler function for the XML parser $parser.

PARAMETERS
	      o $parser
		- A reference to the XML parser to set up character data handler function.

	      o $handler
		-$handler  is  a  string  containing the name of a function that must exist when xml_parse(3) is called for $parser.  The function
		named by $handler must accept two parameters:
		 handler (resource  $parser, string  $data)

		     o $parser
		       - The first parameter, parser, is a reference to the XML parser calling the handler.

		     o $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  frag-
	      ment (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.

PHP Documentation Group 											 XML_SET_CHARACTER_DATA_HANDLER(3)