Struct Input

pub struct Input<T> { /* private fields */ }

An input builder.

Implementations

impl<T> Input<T>

pub fn new() -> Self

Construct a new empty Input.

Identical to Input::default().

pub fn prompt<S: Into<String>>(self, prompt: S) -> Self

Set the prompt to display before waiting for user input.

pub fn prefix<S: Into<String>>(self, prefix: S) -> Self

Set the prompt prefix.

pub fn suffix<S: Into<String>>(self, suffix: S) -> Self

Set the prompt suffix.

pub fn default(self, default: T) -> Self

Set the default value.

If set, this will be returned in the event the user enters an empty input.

pub fn matches<F>(self, matches: F) -> Self

where F: Fn(&T) -> bool + 'static,

Check input values.

If set, this function will be called on the parsed user input and only if it passes will we return the value.

Examples

let num: u32 = Input::new().matches(|x| *x != 10).get();

impl<T> Input<T>

where T: FromStr, <T as FromStr>::Err: Display,

pub fn get(self) -> T

Consumes the Input and reads the input from the user.

This function uses FromStr to parse the input data.

let num: u32 = Input::new().prompt("Enter a number: ").get();

Examples found in repository

examples/guessing_game.rs (line 19)

fn main() {
    let mut num = random();
    println!("Try guess the number I am thinking of 😃 ...");
    println!("  (hint: it's between 0 and 255)\n");

    loop {
        let guess: u32 = casual::prompt("Enter your guess: ").get();

        if guess < num {
            println!("Too low!");
        } else if guess > num {
            println!("Too high!");
        } else {
            println!("You got it!");
            println!("The number was: {}\n", num);

            if casual::confirm("Do you want to play again?") {
                num = random();
            } else {
                break;
            }
        }
    }
}

pub fn map<F, U>(self, map: F) -> U

where F: Fn(T) -> U,

Consumes the Input and applies the given function to it.

This function uses FromStr to parse the input data. The result is then fed to the given closure.

let value = Input::new().map(|s: String| &s.to_lowercase() == "yes");

Trait Implementations

impl<T: Debug> Debug for Input<T>

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

Formats the value using the given formatter.

impl<T> Default for Input<T>

fn default() -> Self

Construct a new empty Input.

Identical to Input::new().