Crate slicedisplay

slicedisplay - lightweight Display for Vecs and slices

slicedisplay is a tiny no-std crate which supplies the SliceDisplay trait.

This trait extends AsRef<[T]> with the display method, which allows formatting without heap allocations.

Requires at least Rust 1.58.

Usage

use slicedisplay::SliceDisplay;

let empty: Vec<u8> = Vec::new();
assert_eq!(empty.display().to_string(), "[]");

let single = Vec::from([1]);
assert_eq!(single.display().to_string(), "[1]");

let numbers = Vec::from([1, 2, 3, 4, 5]);
assert_eq!(numbers.display().to_string(), "[1, 2, 3, 4, 5]");

It’s also possible to slightly customize the display.

use slicedisplay::SliceDisplay;

let hello: Vec<_> = "Hello".chars().collect();
assert_eq!(
    hello.display().delimiter(';').to_string(),
    "[H; e; l; l; o]"
);
assert_eq!(
    hello.display().terminator('{', '}').to_string(),
    "{H, e, l, l, o}"
);
assert_eq!(
    hello
        .display()
        .terminator('(', ')')
        .delimiter(';')
        .to_string(),
    "(H; e; l; l; o)"
);

assert_eq!(
    hello
        .display()
        .terminator('(', ')')
        .delimiter(';')
        .should_space(false)
        .to_string(),
    "(H;e;l;l;o)"
);

Structs

SliceDisplayImpl

Helper struct for printing Vecs and slices.

Traits

SliceDisplay

Configurable Display implementation for slices and Vecs.