Crate unicode_normalization

Expand description

Unicode character composition and decomposition utilities as described in Unicode Standard Annex #15.

extern crate unicode_normalization;

use unicode_normalization::char::compose;
use unicode_normalization::UnicodeNormalization;

fn main() {
    assert_eq!(compose('A','\u{30a}'), Some('Å'));

    let s = "ÅΩ";
    let c = s.nfc().collect::<String>();
    assert_eq!(c, "ÅΩ");
}

crates.io

You can use this package in your project by adding the following to your Cargo.toml:

[dependencies]
unicode-normalization = "0.1.20"

Modules

char

Methods for composing and decomposing characters.

Structs

Decompositions

External iterator for a string decomposition’s characters.

Recompositions

External iterator for a string recomposition’s characters.

Replacements

External iterator for replacements for a string’s characters.

StreamSafe

UAX15-D4: This iterator keeps track of how many non-starters there have been since the last starter in NFKD and will emit a Combining Grapheme Joiner (U+034F) if the count exceeds 30.

The QuickCheck algorithm can quickly determine if a text is or isn’t normalized without any allocations in many cases, but it has to be able to return Maybe when a full decomposition and recomposition is necessary.

Constants

UNICODE_VERSION

Traits

UnicodeNormalization

Methods for iterating over strings while applying Unicode normalizations as described in Unicode Standard Annex #15.

Functions

is_nfc

Authoritatively check if a string is in NFC.

is_nfc_quick

Quickly check if a string is in NFC, potentially returning IsNormalized::Maybe if further checks are necessary. In this case a check like s.chars().nfc().eq(s.chars()) should suffice.

is_nfc_stream_safe

Authoritatively check if a string is Stream-Safe NFC.

is_nfc_stream_safe_quick

Quickly check if a string is Stream-Safe NFC.

is_nfd

Authoritatively check if a string is in NFD.

is_nfd_quick

Quickly check if a string is in NFD.

is_nfd_stream_safe

Authoritatively check if a string is Stream-Safe NFD.

is_nfd_stream_safe_quick

Quickly check if a string is Stream-Safe NFD.