How to Use the unicode-segmentation Crate for Grapheme Clusters

Use the unicode_segmentation crate's Graphemes iterator to split a string into user-perceived characters, handling complex cases like emojis and combining marks correctly.

use unicode_segmentation::UnicodeSegmentation;

let text = "Hello 🌍!";
for grapheme in text.graphemes(true) {
    println!("{grapheme}");
}

This code prints each grapheme cluster on a new line, ensuring that multi-byte characters like the globe emoji are treated as single units.

Grapheme clusters are the visual units of text that users see, which can differ from the raw data bytes or standard characters. This tool ensures your code treats complex symbols, like emojis or accented letters, as single items rather than breaking them apart. Think of it as counting words by how they look to a human, not by how many letters are typed.