#truncate #unicode #pad #unicode-text #unicode-width #width #text

no-std unicode-truncate

Unicode-aware algorithm to pad or truncate str in terms of displayed width

6 releases (3 stable)

2.0.0 Nov 10, 2024
1.1.0 Jul 9, 2024
1.0.0 Apr 27, 2024
0.2.0 Dec 17, 2020
0.1.1 Aug 15, 2019

#231 in Text processing

Download history 71255/week @ 2025-01-18 76064/week @ 2025-01-25 79622/week @ 2025-02-01 83546/week @ 2025-02-08 80601/week @ 2025-02-15 90947/week @ 2025-02-22 98057/week @ 2025-03-01 107637/week @ 2025-03-08 105875/week @ 2025-03-15 96411/week @ 2025-03-22 98335/week @ 2025-03-29 107674/week @ 2025-04-05 95923/week @ 2025-04-12 105716/week @ 2025-04-19 108177/week @ 2025-04-26 114762/week @ 2025-05-03

440,855 downloads per month
Used in 951 crates (29 directly)

MIT/Apache

27KB
399 lines

unicode-truncate

Unicode-aware algorithm to pad or truncate str in terms of displayed width.

crates.io Documentation Build Status

Examples

Safely truncate string to display width even not at character boundaries.

use unicode_truncate::UnicodeTruncateStr;

fn main() {
    assert_eq!("你好吗".unicode_truncate(5), ("你好", 4));
}

Making sure the string is displayed in exactly number of columns by combining padding and truncating.

use unicode_truncate::UnicodeTruncateStr;
use unicode_truncate::Alignment;
use unicode_width::UnicodeWidthStr;

fn main() {
    let str = "你好吗".unicode_pad(5, Alignment::Left, true);
    assert_eq!(str, "你好 ");
    assert_eq!(str.width(), 5);
}

Features

unicode-truncate can be built without std by disabling the default feature std. However, in that case unicode_truncate::UnicodeTruncateStr::unicode_pad won't be available because it depends on std::string::String and std::borrow::Cow.

Dependencies

~2.5MB
~35K SLoC