llcio 0.1.0

LLCs Input Optimations, simpler input of various datatypes
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137

use std::io::{self, Write};

/// A basic function to read a line of input from the user
/// 
/// # Arguments
/// 
/// * `prompt` - The prompt to display to the user
/// 
/// # Returns
/// 
/// * `Result<String, io::Error>` - The string entered by the user or an error

pub fn input(prompt: &str) -> Result<String, io::Error> {
    print!("{}", prompt);
    io::stdout().flush().unwrap();

    let mut input = String::new();
    match io::stdin().read_line(&mut input) {
        Ok(_) => Ok(input.trim().to_string()),
        Err(e) => Err(e)
    }
}

/// A function to get integer input from the user with a prompt
/// 
/// # Arguments
/// 
/// * `prompt` - The prompt to display to the user
/// 
/// # Returns
/// 
/// * `i32` - The integer entered by the user

pub fn intput(prompt: &str) -> i32 {
    loop {
        match input(prompt) {
            Ok(input_str) => {
                match input_str.parse::<i32>() {
                    Ok(num) => return num,
                    Err(_) => {
                        println!("Please enter a valid integer.");
                        continue;
                    }
                }
            }
            Err(_) => {
                println!("Failed to read input. Please try again.");
                continue;
            }
        }
    }
}

/// A function to get string input from the user with a prompt
/// 
/// # Arguments
/// 
/// * `prompt` - The prompt to display to the user
/// 
/// # Returns
/// 
/// * `String` - The string entered by the user
/// 

pub fn strinput(prompt: &str) -> String {
    input(prompt).unwrap_or_else(|_| {
        println!("Failed to read input. Returning empty string.");
        String::new()
    })
}

/// A function to get boolean input from the user with a prompt
/// 
/// Accepts "yes"/"no", "y"/"n", "true"/"false", or "1"/"0" as valid inputs
/// 
/// # Arguments
/// 
/// * `prompt` - The prompt to display to the user
/// 
/// # Returns
/// 
/// * `bool` - The boolean value entered by the user
/// 
/// # Examples
///
pub fn boolput(prompt: &str) -> bool {
    loop {
        match input(prompt) {
            Ok(input_str) => {
                let input_lower = input_str.to_lowercase();
                match input_lower.as_str() {
                    "yes" | "y" | "true" | "1" => return true,
                    "no" | "n" | "false" | "0" => return false,
                    _ => {
                        println!("Please enter a valid boolean value (yes/no, y/n, true/false, 1/0).");
                        continue;
                    }
                }
            }
            Err(_) => {
                println!("Failed to read input. Please try again.");
                continue;
            }
        }
    }
}

/// A function to get floating-point input from the user with a prompt
/// 
/// # Arguments
/// 
/// * `prompt` - The prompt to display to the user
/// 
/// # Returns
/// 
/// * `f64` - The floating-point number entered by the user
/// 

pub fn floatput(prompt: &str) -> f64 {
    loop {
        match input(prompt) {
            Ok(input_str) => {
                match input_str.parse::<f64>() {
                    Ok(num) => return num,
                    Err(_) => {
                        println!("Please enter a valid floating-point number.");
                        continue;
                    }
                }
            }
            Err(_) => {
                println!("Failed to read input. Please try again.");
                continue;
            }
        }
    }
}