Latest web development tutorials
 

PHP xml_set_processing_instruction_handler() Function


< Complete PHP XML Reference

Definition and Usage

The xml_set_processing_instruction_handler() function specifies a function to be called when the parser finds a processing instruction in the XML document.

A processing instruction is enclosed in <? and ?> delimiters and contains a a target followed by data.

Example: In this case the processing instruction associates a style sheet with an XML document:

<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet href="default.xsl" type="text/xml"?>
<note>
<to>Tove</to>
<from>Jani</from>
<heading>Reminder</heading>
<body>Don't forget me this weekend!</body>
</note>

This function returns TRUE on success, or FALSE on failure.

Syntax

xml_set_processing_instruction_handler(parser,handler)

Parameter Description
parser Required. Specifies XML parser to use
handler Required. Specifies a function to be when the parser finds a notation declaration

The Function specified by the "handler" parameter must have three parameters:

Parameter Description
parser Required. Specifies a variable containing the XML parser calling the handler
target Required. Specifies a variable containing processing instruction target
data Required. Specifies a variable containing processing instruction data

Tips and Notes

Note: The handler parameter can also be an array containing an object reference and a method name.


Example

<?php $parser=xml_parser_create();

function char($parser,$data)
  {
  echo $data;
  }

function pi_handler($parser, $target, $data)
  {
  echo "Target: $target<br />";
  echo "Data: $data<br />";
  }

xml_set_character_data_handler($parser,"char");
xml_set_processing_instruction_handler($parser, "pi_handler");
$fp=fopen("test.xml","r");

while ($data=fread($fp,4096))
  {
  xml_parse($parser,$data,feof($fp)) or
  die (sprintf("XML Error: %s at line %d",
  xml_error_string(xml_get_error_code($parser)),
  xml_get_current_line_number($parser)));
  }

xml_parser_free($parser);
?>

< Complete PHP XML Reference