Struct Separators

pub struct Separators { /* private fields */ }

Displays a sequence of elements as comma separated list with a final separator.

Examples

assert_eq!(
   Separators::new(", ", " or ").with(&["a", "b", "c"]).to_string(),
   "a, b or c",
);
assert_eq!(
   Separators::comma_or().with(&["a", "b", "c"]).to_string(),
   "a, b or c",
);

Implementations

impl Separators

pub fn new( separator: &'static str, terminal_separator: impl Into<Option<&'static str>>, ) -> Self

Creates a new sequence to display.

Examples

assert_eq!(
    Separators::new("-", None).with(["a", "b", "c"]).to_string(),
    "a-b-c",
);
assert_eq!(
    Separators::new("-", "/").with(["a", "b", "c"]).to_string(),
    "a-b/c",
);

pub fn comma() -> Self

Creates a new sequence to display using only , as separator.

Examples

assert_eq!(
   Separators::comma().with(["a", "b"]).to_string(),
   "a, b",
);
assert_eq!(
   Separators::comma().with(["a", "b", "c"]).to_string(),
   "a, b, c",
);

pub fn comma_or() -> Self

Creates a new sequence to display using , and or as the separators.

Examples

assert_eq!(
    Separators::comma_or().with(["a", "b"]).to_string(),
    "a or b",
);
assert_eq!(
    Separators::comma_or().with(["a", "b", "c"]).to_string(),
    "a, b or c",
);

pub fn comma_and() -> Self

Creates a new sequence to display using , and and as the separators.

Examples

assert_eq!(
   Separators::comma_and().with(["a", "b"]).to_string(),
   "a and b",
);
assert_eq!(
   Separators::comma_and().with(["a", "b", "c"]).to_string(),
   "a, b and c",
);

pub fn with<S>(self, items: S) -> impl Display

where S: IntoIterator, S::IntoIter: ExactSizeIterator, S::Item: Display,

Formats th given items with this sequence’s separators.

Examples

assert_eq!(
   Separators::new(", ", " or ").with(["a", "b", "c"]).to_string(),
   "a, b or c",
);
assert_eq!(
   Separators::comma_or().with(["a", "b", "c"]).to_string(),
   "a, b or c",
);

Trait Implementations

impl Clone for Separators

fn clone(&self) -> Separators

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Separators

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for Separators

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Separators

fn eq(&self, other: &Separators) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Separators

impl Eq for Separators

impl StructuralPartialEq for Separators