parse-entity

function

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

Returns: the parsed entity value


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


Purpose

The markup source function parse-entity is used to read and parse 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 or its format is not recognized, parse-entity throws resolution-failure.

The parse-entity function is dynamic. Its default implementation on the base entity-resolver type always throws resolution-failure, while its overriding on oasis.catalog-type assumes the entity is well-formed XML.