PHP Manual
Prev |  | Next

# xml_set_notation_decl_handler

(PHP 3 >= 3.0.6, PHP 4, PHP 5)

xml_set_notation_decl_handler -- Set up notation declaration handler

## Description

bool xml_set_notation_decl_handler ( resource parser, callback handler )

Sets the notation declaration 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 notation declaration is part of the document's DTD and has the following format:

    <!NOTATION <parameter>name</parameter>
    { <parameter>systemId</parameter> | <parameter>publicId</parameter>?>

See section 4.7 of the XML 1.0 spec for the definition of notation declarations.

The function named by handler must accept five parameters: handler ( resource parser, string notation_name, string base, string system_id, string public_id )

parser

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

notation_name

  This is the notation's name, as per the notation format described above.

base

  This is the base for resolving the system identifier (system_id) of the notation declaration. Currently this parameter will always be set to an empty string.

system_id

  System identifier of the external notation declaration.

public_id

  Public identifier of the external notation declaration.

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.

> Note: Instead of a function name, an array containing an object reference and a method name can also be supplied.

Prev | Home | Next
xml_set_external_entity_ref_handler | Up | xml_set_object