Yet another crate for easily reading values from strings or input.

It was made to mimic cin >> functionality and to be usable for parsing text input in format used in algorithmic contests.

Documentation (0.4.3)

Crate

Changelog

Features:

• Function-based interface (as opposed to macro-based one).
• Simple: only whitespace can separate values, hence name. (so it's not a general solution for parsing arbitrary data).
• Parsing in newline-agnostic mode (just like cin >>). (Line-aware mode is also supported)
• Easy detection of end of input.
• Proper (Result, not panics) handling of errors.
• No unnecessary allocs and locks.
• "One-file" copy-pastable implementation with no dependencies. This crate uses modules, but you can use cargo run to generate a concatenated single-file template (see below).

Examples

Reading an integer from stdin:

let x: i32 = parse_line().unwrap();

Tuples and vectors (nest everything as you like)!

let tup: (i32, f64) = parse_string("  5  3.14 ").unwrap();
let v: Vec<(String, u8)> = parse_string("one 1 two 2 three 3").unwrap();

Wrapping StdinLock for non-line-based parsing...

let i = std::io::stdin();
let mut i = Reader::new(i.lock());

// (almost) equivalent to scanf("%d%d", &a, &b) or cin >> a >> b
let (a, b): (i32, i32) = i.parse().unwrap();

...or just for speed:

while let Ok((x, y)) = i.line::<(usize, f32)>() {
	println!("{} {}", y, x);
}

Reading a file (can also use Reader for more control):

let number: i32 = parse_file("number.txt").unwrap();

Installation

cargo add whiteread or add this to your Cargo.toml:

[dependencies]
whiteread = "0.4.3"

Using in non-Cargo environment

If you want to use this crate where cargo is unavailable, whiteread can be squished into single file. Here's how to generate a template containing a whiteread module:

$ cargo install whiteread
$ whiteread-template > my_file.rs

Alternatively, you can clone this repository and just cargo run.