What is PhpDig?
PhpDig is a PHP MySQL based
Web Spider & Search Engine.

xml_set_character_data_handler
Prev	LXVII. XML Functions	Next

xml_set_character_data_handler

Name

xml_set_character_data_handler — Sets the character handler for the specified XML parser.

Synopsis

int xml_set_character_data_handler(parserID, handler); resource parserID: Reference to a valid parser string handler: Function to be used as an event handler

Returns

TRUE on success; FALSE on error

Description

Handles data for all non-markup content; see the example code. Setting the handler to FALSE or an empty string disables the handler. The function returns FALSE if the parser is invalid or the handler was not created.

The function prototype should have the following parameters:

Parameter	Description
parser	Reference to the XML parser that uses this function
data	Character data

Version

PHP 3 >= 3.0.6, PHP 4 >= 4.0b1

Example

Example 1431. Set and print the contents from the character handler

// function to handle characters
function character_handler($parser, $data) { 
   print "$data<BR />";
}

$xmlfile = 'myxmlfile.xml';
$xmlparser = xml_parser_create();
xml_set_character_data_handler($xmlparser, "character_handler");

// open a file and read data from it for parsing
$fp = fopen($xmlfile, 'r');
while ($xmldata = fread($fp, 1024)) {

      // parse the data chunk
      if (!xml_parse($xmlparser, $xmldata, feof($fp))) {

            // if parsing fails print the error description and line number
            die( print "ERROR: "
              . xml_error_string(xml_get_error_code($xmlparser))
              . "<BR />"
              . "Line: "
              . xml_get_current_line_number($xmlparser)
              . "<BR />"
              . "Column: "
              . xml_get_current_column_number($xmlparser)
              . "<BR />");
   }
}

// free the parser memory
xml_parser_free($xmlparser);

Prev	Home	Next
xml_parse_into_struct	Up	xml_set_default_handler

PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing (Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch). This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). The authors of this book have elected not to choose any options under the OPL. This online book was obtained from http://www.fooassociates.com/phpfer/ and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4 for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All persons and entities shall have neither liability nor responsibility to any person or entity with respect to any loss or damage arising from the information contained in this book.