public-identifier of

operator

Return type:
String
Returns:
The public identifier for the currently-active external entity.
Syntax
public-identifier of entity
    


Purpose

public-identifier of entity retrieves the public identifier of the currently-active external entity, if any. It can be used in an external-data-entity rule or a external-text-entity rule, or in the dynamic scope created by the execution of these rules. So, in a function called from the body of an external-text-entity rule, public-identifier of entity will evaluate to the public identifier of the entity that fired the rule. If the currently-active entity is a defaulted entity, public-identifier of entity will evaluate to the public identifier of the default entity as it was declared in the input DTD.

In an external-data-entity rule or an external-text-entity rule, the format item %pq is a shorthand for public-identifier of entity.

It is an error to invoke public-identifier of entity for an entity that was not declared with a public identifier. When in doubt, public-identifier of entity should be preceded by the entity is public test:

  do when entity is public
     output public-identifier of entity