PHP xml_set_notation_decl_handler() Function

The xml_set_notation_decl_handler() function specifies a function to be called when the parser finds a notation declaration in the XML document.This function returns TRUE on success, or FALSE on failure.

bool xml_set_notation_decl_handler ( resource $parser , callable $handler )

Sets the notation declaration handler function for the XML parser 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>?>

Example -

ParameterDescription
parserA reference to the XML parser to set up notation declaration handler function.
handlerRequired. Specifies a function to be when the parser finds a notation declaration

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

ParameterDescription
parserThe first parameter, parser, is a reference to the XML parser calling the handler.
notation_nameThis is the notation's name, as per the notation format described above.
baseThis 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_idSystem identifier of the external notation declaration.
public_idPublic identifier of the external notation declaration.If a handler function is set to an empty string, or FALSE, the handler in question is disabled.

Returns TRUE on success or FALSE on failure.