Crate display_utils

This library aims to provide useful constructs to vastly simplify data formatting tasks.

Being a no_std library, no allocations will be made, ever. Even with this restriction however, the provided functions are flexible and ergonomic.

This code snippet:

for (i, item) in list.iter().enumerate() {
    if i == list.len() - 1 {
        println!("{}", item);
    } else {
        print!("{} - ", item);
    }
}

…simplifies to:

println!("{}", display_utils::join(list, " - "));

Other functions work in a similar fashion. Browser through the crate functions for an overview of what you can do.

Extension traits (DisplayExt, IteratorExt) which may be used to make method chains more readable.

Macros

concat

Concatenate arbitrarily many instances of different types.

Structs

Concat

See concat().

DisplaySlice

See slice();

Join

See join().

JoinFormat

See join_format().

Lowercase

See lowercase().

Ordinal

See ordinal().

Repeat

See repeat().

Replace

See replace().

ReplaceN

See replace_n().

UnicodeBlockBar

See unicode_block_bar().

Uppercase

See uppercase().

VerticalUnicodeBlockBars

See vertical_unicode_block_bars().

Traits

DisplayExt

Extension trait providing convenient access to the base functions in the crate root.

IteratorExt

Extension trait providing convenient access to the base functions in the crate root.

Functions

cmp

Lexicographically compares a Display object against a string.

collect_str

Write a Display object into a fixed-size buffer and returns the resulting &str.

collect_str_mut

Write a Display object into a fixed-size buffer and returns the resulting &mut str.

concat

Concatenate the contents of an iterator.

join

Concatenate iterator elements, separating each element pair with a given joiner.

join_format

Concatenate iterator elements, separating each element pair with a given joiner, where each iterator element can be formatted using a callback.

lowercase

Print a Unicode-compliant lowercase version of the Display object.

ordinal

Create an ordinal from a number.

repeat

Repeat an object a certain number of times.

replace

Replace instances of the from string with the to Display object.

replace_n

Replace the first n instances of the from string with the to string.

slice

Extract a slice from the given Display object, similar to indexing a &str.

unicode_block_bar

Print a loading-style bar using Unicode block characters.

uppercase

Print a Unicode-compliant uppercase version of the string.

vertical_unicode_block_bars

Print a sequence of equalizer-style vertical bars using Unicode block characters.