char_str 0.0.2

Compact owned string types forked from lean_string for Ruff and ty.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

use core::hint::black_box;
use std::time::Duration;

use char_str::{CharStr, CharString, format_char, format_char_str};
use criterion::{BenchmarkId, Criterion, Throughput, criterion_group, criterion_main};

struct Case {
    name: &'static str,
    value: &'static str,
}

const CASES: [Case; 2] = [
    Case { name: "inline", value: "name" },
    Case { name: "heap", value: "a_name_longer_than_the_inline_limit" },
];

fn char_string(c: &mut Criterion) {
    let mut group = c.benchmark_group("formatting/char_string");

    for case in &CASES {
        group.throughput(Throughput::Bytes((case.value.len() + 1) as u64));
        group.bench_function(BenchmarkId::new("format_char", case.name), |b| {
            b.iter(|| {
                let value = black_box(case.value);
                black_box(format_char!("{value}="))
            })
        });
        group.bench_function(BenchmarkId::new("format_then_convert", case.name), |b| {
            b.iter(|| {
                let value = black_box(case.value);
                black_box(CharString::from(format!("{value}=")))
            })
        });
    }

    group.finish();
}

fn char_str(c: &mut Criterion) {
    let mut group = c.benchmark_group("formatting/char_str");

    for case in &CASES {
        group.throughput(Throughput::Bytes((case.value.len() + 1) as u64));
        group.bench_function(BenchmarkId::new("format_char_str", case.name), |b| {
            b.iter(|| {
                let value = black_box(case.value);
                black_box(format_char_str!("{value}="))
            })
        });
        group.bench_function(BenchmarkId::new("format_then_convert", case.name), |b| {
            b.iter(|| {
                let value = black_box(case.value);
                black_box(CharStr::from(format!("{value}=")))
            })
        });
    }

    group.finish();
}

criterion_group! {
    name = benches;
    config = Criterion::default()
        .warm_up_time(Duration::from_millis(500))
        .measurement_time(Duration::from_secs(2))
        .sample_size(50);
    targets = char_string, char_str
}
criterion_main!(benches);