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

xml_set_element_handler
Prev	LXVII. XML Functions	Next

xml_set_element_handler

Name

xml_set_element_handler — Sets the starting and ending handlers for the specified XML parser.

Synopsis

int xml_set_element_handler(parserID, starthandler, endhandler); resource parserID: Reference to a valid parser string starthandler: Function to be used as the starting event handler string endhandler: Function to be used as the ending event handler

Returns

TRUE on success; FALSE on error

Description

The starting handler fires when the opening tag of an element is found; the ending handler fires when the closing tag of an element is found by the parser. 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 start element function prototype should have the following parameters:

Parameter	Description
parser	Reference to the XML parser that uses this function
elementname	Name of the element
attributes	Associative array containing the attributes of the element

The end element function prototype should have the following parameters:

Parameter	Description
parser	Reference to the XML parser that uses this function
elementname	Name of the element

Version

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

Example

Example 1433. Set element handlers

function starting_handler($parser, $elementname, $attributes) {
   print "Starting handler for $elementname <BR />";
}

function ending_handler($parser, $elementname) {
      print "Ending handler for $elementname <BR />";
}

$xmlfile = 'myxmlfile.xml';
$xmlparser = xml_parser_create();
xml_set_element_handler($xmlparser, "starting_handler", "ending_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_set_default_handler	Up	xml_set_external_entity_ref_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.