hfs_nfd 0.1.0

Handle Apple's unique NFD-like Unicode normalization, which is used in HFS+, in Rust.
Documentation

Apple HFS+ NFD-like Unicode Normalization Library for Rust

CI (master) CI (Release) hfs_nfd at crates.io hfs_nfd at docs.rs

HFS+, the file system formerly used in Apple macOS, uses a unique Unicode normalization similar to NFD.

This library composes or decomposes Unicode code points according to the normalization. e.g.

  • Université[U+00E9] de Paris (Common) ⇔ Université[U+0065 U+0301] de Paris (HFS+)
  • アップ[U+30D7]ル (Common) ⇔ アップ[U+30D5 U+309A]ル (HFS+)

How to use

Add this library hfs_nfd to your Cargo.toml.

[dependencies]
another_library1 = "<version>"
another_library2 = "<version>"
# *snip*
hfs_nfd = "<replace with the latest version by yourself>" # <= Here
# *snip*

Then, use these functions:

use hfs_nfd::{compose_from_hfs_nfd,decompose_into_hfs_nfd}

assert_eq!(decompose_into_hfs_nfd("Universit\u{00E9}"), "Universite\u{0301}".to_string());
assert_eq!(compose_from_hfs_nfd("アッフ\u{309A}ル"), "アッ\{30D7}ル".to_string());

Restrictions

In HFS+, Korean Hangul characters are also composed or decomposed in the way other than what is listed on the table.

In addition, the Korean Hangul characters with codes in the range u+AC00 through u+D7A3 are illegal and must be replaced with the equivalent sequence of conjoining jamos, as described in the Unicode 2.0 book, section 3.10.

I've not implemented it yet.

Please don't hasitate to send a PR on this if you feel inconvenience. These pages may be help you: