om.XmlReader.skippedEntity

Returns the name of an unresolved entity.

Syntax

skippedEntity()
  RETURNS STRING

Usage

The skippedEntity() method returns the name of the unresolved entity, in the SkippedEntity event context.

The parser identifies well know character entities such as & / ' / < / > / ", other character entities are treated as skipped entities and can be processed in the SkippedEntity event.

Example

DEFINE r om.XmlReader,
       e STRING
   ...
   LET e = r.read()
   WHILE e IS NOT NULL
     CASE e 
       ...
       WHEN "SkippedEntity"
         DISPLAY "Entity:'",r.skippedEntity(),"'"
     ...

For a complete example, see Example 1: Parsing an XML file.