Enum Pattern 

pub enum Pattern {
    Lowercase,
    Uppercase,
    Capital,
    Sentence,
    Camel,
    Alternating,
    Toggle,
}

A pattern is how a set of words is mutated before joining with a delimeter.

The Random and PseudoRandom patterns are used for their respective cases and are only available in the “random” feature.

Variants

Lowercase

Lowercase patterns make all words lowercase.

use convert_case::Pattern;
assert_eq!(
    vec!["case", "conversion", "library"],
    Pattern::Lowercase.mutate(&["Case", "CONVERSION", "library"])
);

Uppercase

Uppercase patterns make all words uppercase.

use convert_case::Pattern;
assert_eq!(
    vec!["CASE", "CONVERSION", "LIBRARY"],
    Pattern::Uppercase.mutate(&["Case", "CONVERSION", "library"])
);

Capital

Capital patterns makes the first letter of each word uppercase and the remaining letters of each word lowercase.

use convert_case::Pattern;
assert_eq!(
    vec!["Case", "Conversion", "Library"],
    Pattern::Capital.mutate(&["Case", "CONVERSION", "library"])
);

Sentence

Capital patterns make the first word capitalized and the remaining lowercase.

use convert_case::Pattern;
assert_eq!(
    vec!["Case", "conversion", "library"],
    Pattern::Sentence.mutate(&["Case", "CONVERSION", "library"])
);

Camel

Camel patterns make the first word lowercase and the remaining capitalized.

use convert_case::Pattern;
assert_eq!(
    vec!["case", "Conversion", "Library"],
    Pattern::Camel.mutate(&["Case", "CONVERSION", "library"])
);

Alternating

Alternating patterns make each letter of each word alternate between lowercase and uppercase. They alternate across words, which means the last letter of one word and the first letter of the next will not be the same letter casing.

use convert_case::Pattern;
assert_eq!(
    vec!["cAsE", "cOnVeRsIoN", "lIbRaRy"],
    Pattern::Alternating.mutate(&["Case", "CONVERSION", "library"])
);
assert_eq!(
    vec!["aNoThEr", "ExAmPlE"],
    Pattern::Alternating.mutate(&["Another", "Example"]),
);

Toggle

Toggle patterns have the first letter of each word uppercase and the remaining letters of each word uppercase.

use convert_case::Pattern;
assert_eq!(
    vec!["cASE", "cONVERSION", "lIBRARY"],
    Pattern::Toggle.mutate(&["Case", "CONVERSION", "library"])
);

Implementations

impl Pattern

pub fn mutate(&self, words: &[&str]) -> Vec<String>

Generates a vector of new Strings in the right pattern given the input strings.

use convert_case::Pattern;

assert_eq!(
    vec!["crack", "the", "skye"],
    Pattern::Lowercase.mutate(&vec!["CRACK", "the", "Skye"]),
)

Trait Implementations

impl Clone for Pattern

fn clone(&self) -> Pattern

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Pattern

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

Formats the value using the given formatter.

impl PartialEq for Pattern

fn eq(&self, other: &Pattern) -> 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 Pattern

impl Eq for Pattern

impl StructuralPartialEq for Pattern