Crate join_string

A simple crate to join the elements of iterators, interspersing a separator between all elements.

This is done somewhat efficiently, if possible, meaning if the iterator is cheaply clonable you can directly print the result of Join::join() without creating a temporary String in memory.

use join_string::Join;
 
assert_eq!(
    "foo bar baz".split_whitespace().join(", ").into_string(),
    "foo, bar, baz");
 
println!("{}",
    "foo bar baz".split_whitespace()
        .map(|s| s.chars().rev().join(""))
        .join(' '));
// Output: oof rab zab

Structs

• DisplayIter
  Iterator-facade that maps an iterator over AsRef<str> to an iterator over DisplayWrapper.
• DisplayWrapper
  Helper for joining elements that only implement AsRef<str>, but not std::fmt::Display.
• Joiner
  Helper struct that captures the iterator and separator for later joining.

Traits

• Join
  Trait that provides a method to join elements of an iterator, interspersing a separator between all elements.

Functions

• join
  Join anything that implements Join, not just iterators. The elements need to implement std::fmt::Display.
• join_str
  Join anything that implements Join, not just iterators when elements don’t implement std::fmt::Display, but implement AsRef<str> instead.