PHP Manual
Prev |  | Next

# xml_set_processing_instruction_handler

(3.0.6 - 3.0.18 only, PHP 4 >= 4.0.0)

xml_set_processing_instruction_handler -- Set up processing instruction (PI) handler

## Description

``int xml_set_processing_instruction_handler` (int parser, string handler)`

Sets the processing instruction (PI) handler function for the XML parser `parser`. `handler` is a string containing the name of a function that must exist when xml_parse() is called for `parser`.

A processing instruction has the following format:

    <?
           target
           data?>

You can put PHP code into such a tag, but be aware of one limitation: in an XML PI, the PI end tag (`?>`) can not be quoted, so this character sequence should not appear in the PHP code you embed with PIs in XML documents. If it does, the rest of the PHP code, as well as the "real" PI end tag, will be treated as character data.

The function named by `handler` must accept three parameters:

```handler`` (int parser, string target, string data)`

`parser`

  The first parameter, `parser`, is a reference to the XML parser calling the handler.

`target`

  The second parameter, `target`, contains the PI target.

`data`

  The third parameter, `data`, contains the PI data.

If a handler function is set to an empty string, or `FALSE`, the handler in question is disabled.

`TRUE` is returned if the handler is set up, `FALSE` if `parser` is not a parser.

There is currently no support for object/method handlers. See xml_set_object() for using the XML parser within an object.

Prev | Home | Next
xml_set_character_data_handler | Up | xml_set_default_handler