9 stable releases

new 1.3.0 Mar 3, 2025
1.2.3 Jan 7, 2025
1.2.1 Dec 12, 2021
0.2.3 Dec 1, 2021
0.0.0 Nov 27, 2021

#531 in Parser implementations

Download history 69/week @ 2024-11-14 62/week @ 2024-11-21 104/week @ 2024-11-28 142/week @ 2024-12-05 334/week @ 2024-12-12 203/week @ 2024-12-19 68/week @ 2024-12-26 316/week @ 2025-01-02 185/week @ 2025-01-09 209/week @ 2025-01-16 107/week @ 2025-01-23 91/week @ 2025-01-30 186/week @ 2025-02-06 161/week @ 2025-02-13 120/week @ 2025-02-20 243/week @ 2025-02-27

718 downloads per month
Used in 3 crates

Unlicense

18KB
393 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
~17K SLoC