8 stable releases

1.2.3 Jan 7, 2025
1.2.1 Dec 12, 2021
0.2.3 Dec 1, 2021
0.2.1 Nov 30, 2021
0.0.0 Nov 27, 2021

#497 in Parser implementations

Download history 75/week @ 2024-09-30 13/week @ 2024-10-07 131/week @ 2024-10-14 49/week @ 2024-10-21 59/week @ 2024-10-28 59/week @ 2024-11-04 44/week @ 2024-11-11 66/week @ 2024-11-18 70/week @ 2024-11-25 119/week @ 2024-12-02 286/week @ 2024-12-09 243/week @ 2024-12-16 136/week @ 2024-12-23 53/week @ 2024-12-30 412/week @ 2025-01-06 192/week @ 2025-01-13

807 downloads per month
Used in 3 crates

Unlicense

18KB
378 lines

Scanf

If you know it from C, same functionality but with memory safety.

scanf! & sscanf!

use scanf::scanf;

let mut number: u32 = 0;
let mut name: String = String::new();
if scanf!("{},{}", number, name).is_ok() {
    println!("Input is: {} and {}", number, name);
}
use scanf::sscanf;

let input = "5,something";
let mut number: u32 = 0;
let mut name: String = String::new();
if let Err(error) = sscanf!(input, "{},{}", number, name) {
    panic!("Error {} using sscanf!", error);
}

Examples

use scanf::scanf;

let mut product: String = String::new();
let mut price: f32 = 0.0;
println!("Insert product and price (product: price):");
if scanf!("{}: {}", product, price).is_ok() {
    println!("Price of {} is {:.2}", product, price);
}
use scanf::sscanf;

let input: &str = "Candy: 2.75";
let mut product: String = String::new();
let mut price: f32 = 0.0;
println!("Insert product and price (product: price):");
sscanf!(input, "{}: {}", product, price);
println!("Price of {} is {:.2}", product, price);
# assert_eq!(product, "Candy");
# assert_eq!(price, 2.75);

It's possible to indicate the type in the format string:

# use scanf::scanf;
let mut product: String = String::new();
let mut price: f32 = 0.0;
println!("Insert product and price (product: price):");
scanf!("{string}: {f32}", product, price);
# println!("Price of {} is {:.2}", product, price);

Also escape brackets:

# use scanf::sscanf;
let input: &str = "{Candy}";
let mut product: String = String::new();
sscanf!(input, "{{{}}}", product);
assert_eq!(product, "Candy");

Examples has been compiled and sscanf's examples also ran as tests. If you have problems using the example code, please, create an issue.

Dependencies

~1MB
~18K SLoC