xot 0.31.2

Full-featured XML tree library for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

use std::borrow::Cow;

#[cfg(doc)]
use crate::Xot;
#[cfg(feature = "icu")]
#[cfg(doc)]
use icu;

/// A normalizer.
///
/// Normalizes text and attribute values. You can pass a normalizer using
/// [`Xot::serialize_xml_string_with_normalizer`] and
/// [`Xot::serialize_xml_write_with_normalizer`].
///
#[cfg_attr(
    feature = "icu",
    doc = r##"
If you enable the `icu` feature, you can use the `icu` normalizers [`icu::normalizer::ComposingNormalizer`] and
[`icu::normalizer::DecomposingNormalizer`] as normalizers."##
)]
pub trait Normalizer {
    /// Given a piece of text, give back the normalized version.
    fn normalize<'a>(&self, content: Cow<'a, str>) -> Cow<'a, str>;

    // in theory we could use normalize_iter on ICU to avoid allocating a string, but
    // that gets too hairy for now
}

/// A normalizer that does nothing at all. This is used by default if
/// you don't specify a normalizer.
pub struct NoopNormalizer;

impl Normalizer for NoopNormalizer {
    #[inline]
    fn normalize<'a>(&self, content: Cow<'a, str>) -> Cow<'a, str> {
        content
    }
}