Skip to main content

truncate

Function truncate 

Source
pub fn truncate(s: &str, max: usize) -> &str
Expand description

Longest prefix of s fitting in max columns, using Width::DEFAULT.

Never allocates and never cuts inside a character or an escape sequence.

Examples found in repository?
examples/bench.rs (line 55)
29fn main() {
30    let ascii = "the quick brown fox jumps over the lazy dog, repeatedly and at length";
31    let cjk = "日本語のテキストはこのように全角文字で構成されていますので幅の計算が必要です";
32    let emoji = "👨‍👩‍👧‍👦 crew 🇯🇵 flag 👍🏽 thumbs 🦊 fox ❤️ heart 🚀 rocket 🎉 party 🌍 world 🔥 fire";
33    let ansi = "\x1b[1;31mred\x1b[0m \x1b[32mgreen\x1b[0m \x1b[34mblue\x1b[0m \x1b[33myellow\x1b[0m plain tail text here";
34    let mixed = "host-01 │ 日本語ログ │ \x1b[32mhealthy\x1b[0m │ 👍🏽 ok";
35
36    println!("width():");
37    bench("ascii", ascii, 200_000);
38    bench("cjk", cjk, 200_000);
39    bench("emoji", emoji, 200_000);
40    bench("ansi", ansi, 200_000);
41    bench("mixed table row", mixed, 200_000);
42
43    let iters = 200_000u32;
44    let t = Instant::now();
45    for _ in 0..iters {
46        black_box(cellwidth::cell(black_box(mixed), 40));
47    }
48    println!(
49        "\ncell() on a table row:       {:>8.0} ns/call (allocates)",
50        t.elapsed().as_secs_f64() / f64::from(iters) * 1e9
51    );
52
53    let t = Instant::now();
54    for _ in 0..iters {
55        black_box(cellwidth::truncate(black_box(mixed), 20));
56    }
57    println!(
58        "truncate() on a table row:   {:>8.0} ns/call (no allocation)",
59        t.elapsed().as_secs_f64() / f64::from(iters) * 1e9
60    );
61}