Struct petname::Petnames

pub struct Petnames<'a> {
    pub adjectives: Vec<&'a str>,
    pub adverbs: Vec<&'a str>,
    pub names: Vec<&'a str>,
}

Word lists and the logic to combine them into petnames.

A petname with n words will contain, in order:

• 1 adjective when n >= 2, otherwise 0 adjectives.
• n - 2 adverbs when n >= 2.
• 1 name / noun.

Fields

adjectives: Vec<&'a str>

adverbs: Vec<&'a str>

names: Vec<&'a str>

Methods

impl<'a> Petnames<'a>

pub fn default() -> Self

Constructs a new Petnames from the default (small) word lists.

pub fn small() -> Self

Constructs a new Petnames from the small word lists.

pub fn medium() -> Self

Constructs a new Petnames from the medium word lists.

pub fn large() -> Self

Constructs a new Petnames from the large word lists.

pub fn init(adjectives: &'a str, adverbs: &'a str, names: &'a str) -> Self

Constructs a new Petnames from the given word lists.

The words are extracted from the given strings by splitting on whitespace.

pub fn retain<F>(&mut self, predicate: F) where
    F: Fn(&&str) -> bool, 

Keep words matching a predicate.

Examples

let mut petnames = petname::Petnames::default();
petnames.retain(|s| s.starts_with("b"));
petnames.generate_one(2, ".");

This is merely a convenience wrapper that applies the same predicate to the adjectives, adverbs, and names lists.

pub fn cardinality(&self, words: u8) -> u128

Calculate the cardinality of this Petnames.

If this is low, names may be repeated by the generator with a higher frequency than your use-case may allow. If it is 0 (zero) the generator will panic (unless words is also zero).

This can saturate. If the total possible combinations of words exceeds u128::MAX then this will return u128::MAX.

pub fn generate<RNG>(&self, rng: &mut RNG, words: u8, separator: &str) -> String where
    RNG: Rng, 

Generate a new petname.

Examples

let mut rng = rand::thread_rng();
petname::Petnames::default().generate(&mut rng, 7, ":");

Panics

If a word list is empty.

pub fn generate_one(&self, words: u8, separator: &str) -> String

Generate a single new petname.

This is like generate but uses rand::thread_rng as the random source. For efficiency use generate when creating multiple names, or when you want to use a custom source of randomness.

Trait Implementations

impl<'a> Default for Petnames<'a>

fn default() -> Self

Returns the "default value" for a type.