Struct Entities 

pub struct Entities<'a> { /* private fields */ }

A set of entities that should be unmapped and how they should be unmapped

Implementations

impl<'a> Entities<'a>

pub fn xml() -> Self

Create a new Entities set for XML entity parsing

pub fn replace_entities(&self, inc_map: bool, s: &str) -> Option<String>

Replace general entity references and &#..; characters, using the map.

Return None if the string has no replacements required; else Some(new string).

The replacements that are used should also be replaced if this is expanding a general entity use.

We don’t handle parameter entities here yet (‘%thing;’)

However, the map should not be used for entity declaration contents in XML hence inc_map is provided. However, character entities &#..; are expanded in entity declarations.

Character entities are ALSO expanded when entities are used.

Another option would be to use two different Entities to handle the two different cases.

An ampersand (&#38;) may be escaped

numerically (&#38;#38;) or with a general entity (&amp;).

“ >

makes ‘example’ be

An ampersand (&) may be escaped numerically (&#38;) or with a general entity (&amp;).

and a reference in a doc to &example; is then replaced with a ‘p’ element with content

An ampersand (&) may be escaped numerically (&) or with a general entity (&).

Trait Implementations

impl<'a> Default for Entities<'a>

fn default() -> Entities<'a>

Returns the “default value” for a type.