xml_set_unparsed_entity_decl_handler

Set up unparsed entity declaration handler

&reftitle.description; `true` `xml_set_unparsed_entity_decl_handler` `XMLParser` `parser` `callable` `handler`

Sets the unparsed entity declaration handler function for the XML parser `parser`.

The `handler` will be called if the XML parser encounters an external entity declaration with an NDATA declaration, like the following:

    <!ENTITY <parameter>name</parameter> {<parameter>publicId</parameter> | <parameter>systemId</parameter>}
            NDATA <parameter>notationName</parameter>

See section 4.2.2 of the XML 1.0 spec for the definition of notation declared external entities.

&reftitle.parameters;

&xml.parser.param;

`handler`

- &xml.handler.description;

  The signature of the handler must be: `void```handler`` `XMLParser` `parser` `string` `entity_name` ``string``false```base` `string` `system_id` ``string``false```public_id` ``string``false```notation_name`

  &xml.handler.parser.param;

  `entity_name`

- 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.

`system_id`

- System identifier for the external entity.

`public_id`

- Public identifier for the external entity.

`notation_name`

- Name of the notation of this entity (see `xml_set_notation_decl_handler`).

&reftitle.returnvalues;

&return.true.always;

&reftitle.changelog;

&Version; | &Description;
&xml.changelog.parser-param;