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.