(3.0.6 - 3.0.18 only, PHP 4 >= 4.0.0)
xml_set_unparsed_entity_decl_handler -- Set up unparsed entity declaration handler
Description
int xml_set_unparsed_entity_decl_handler (int parser, string
handler)
Sets the unparsed entity 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.
This handler will be called if the XML parser encounters an external entity declaration
with an NDATA declaration, like the following:
<!ENTITY name {publicId | systemId}
NDATA notationName>
|
See
section 4.2.2 of the XML 1.0 spec for the definition of notation declared external
entities.
The function named by handler must accept six parameters:
handler (int parser, string entityName, string base, string
systemId, string publicId, string notationName)
- parser
-
The first parameter, parser, is a reference to the XML parser calling the
handler.
- entityName
-
The name of the entity that is about to be defined.
- base
-
This is the base for resolving the system identifier (systemId) of the
external entity. Currently this parameter will always be set to an empty string.
- systemId
-
System identifier for the external entity.
- publicId
-
Public identifier for the external entity.
- notationName
-
Name of the notation of this entity (see
xml_set_notation_decl_handler()).
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.
|
