Struct read_input::InputBuilder

pub struct InputBuilder<T: FromStr> { /* fields omitted */ }

'builder' used to store the settings that are used to fetch input.

.get() method only takes these settings by reference so can be called multiple times.

This type does not have support for default input value.

Methods

impl<T: FromStr> InputBuilder<T>

pub fn new() -> Self

Creates a new instance of InputBuilder with default settings.

pub fn get(&self) -> T

'gets' the input form the user.

Panics if unable to read input line.

pub fn try_get(&self) -> Result<T>

'gets' the input form the user.

Errors

Returns Err if unable to read input line.

pub fn default(self, default: T) -> InputBuilderOnce<T>

Changes or adds a default input value.

Trait Implementations

impl<T: FromStr + Clone> Clone for InputBuilder<T>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: FromStr> Default for InputBuilder<T>

fn default() -> Self

Returns the "default value" for a type.

impl<T: FromStr> InputBuild<T> for InputBuilder<T>

fn msg(self, msg: impl ToString) -> Self

Changes or adds a prompt message that gets printed once when input if fetched.

fn repeat_msg(self, msg: impl ToString) -> Self

Changes or adds a prompt message and that is repeated each time input is requested.

fn err(self, err: impl ToString) -> Self

Changes fallback error message.

fn add_test<F: Fn(&T) -> bool + 'static>(self, test: F) -> Self

Adds a validation check on input.

fn add_err_test<F>(self, test: F, err: impl ToString) -> Self where
    F: Fn(&T) -> bool + 'static, 

Adds a validation check on input with a custom error message printed when the test fails.

fn clear_tests(self) -> Self

Removes all validation checks made by .add_test(), .add_err_test(), .inside() and .inside_err().

fn err_match<F>(self, err_match: F) -> Self where
    F: Fn(&T::Err) -> Option<String> + 'static, 

Used specify custom error messages that depend on the errors produced by from_str().

fn inside<U: InsideFunc<T>>(self, constraint: U) -> Self

Ensures that input is within a range, array or vector.

fn inside_err<U: InsideFunc<T>>(self, constraint: U, err: impl ToString) -> Self

Ensures that input is within a range, array or vector with a custom error message printed when input fails.

fn toggle_msg_repeat(self) -> Self

Toggles whether a prompt message gets printed once or each time input is requested.

impl<T: FromStr + PartialOrd + 'static> InputConstraints<T> for InputBuilder<T>

fn min(self, min: T) -> Self

Sets a minimum input value.

fn min_err(self, min: T, err: impl ToString) -> Self

Sets a minimum input value with custom error message.

fn max(self, max: T) -> Self

Sets a maximum input value.

fn max_err(self, max: T, err: impl ToString) -> Self

Sets a maximum input value with custom error message.

fn min_max(self, min: T, max: T) -> Self

Sets a minimum and maximum input value.

fn min_max_err(self, min: T, max: T, err: impl ToString) -> Self

Sets a minimum and maximum input value with custom error message.

fn not(self, this: T) -> Self

Sets a restricted input value.

fn not_err(self, this: T, err: impl ToString) -> Self

Sets a restricted input value with custom error message.