read-entity

function

Library: Markup utilities (OMMARKUPUTILITIES)
Import : ommarkuputilities.xmd

Returns: the unparsed entity text


Declaration
export dynamic string source function
   read-entity  via value entity-resolver resolver
               from value string          uri
    


Purpose

The string source function read-entity is used to read the entity value from its resolved URI. This function is usually applied to the URI returned by map-external-identifier. If the entity value cannot be read, read-entity throws resolution-failure.

The read-entity function is dynamic. Its default implementation on the base entity-resolver type works only with the local files, while its overriding on oasis.catalog-type accepts FTP and HTTP URIs as well.