8 releases

0.2.0 Oct 6, 2022
0.1.6 Mar 26, 2021
0.1.5 Dec 19, 2020
0.1.4 Nov 1, 2020
0.1.2 Oct 31, 2020

#111 in Parser tooling

43 downloads per month

MIT license

18KB
260 lines

Rust

FastInput - Read input, fast!

FastInput is aimed to simplify reading of known input from stdin, mainly in a competetive programming environment. The crate exposes the FastInput struct which contains methods for reading and parsing line-based input. FastInput does no validation of the input and uses unsafe operations and buffering to achieve great performance.

Example

The following example creates a new FastInput and reads some input:

// The `next` method comes from the `FastParse` trait.
use fast_input::{FastInput, FastParse, Str};

let input = FastInput::new();
let first_line = input.next_line();

// Type arguments can often be omitted as rust is awesome,
// specified here for clarity.
let (a, b): (u32, u32) = input.next();

println!("First line was: {}, a + b = {}", first_line, a + b);

// Read the next line and parse it.
let age: u32 = input.next_parsed();

// Read a line of integers and collect into a `Vec`
let numbers: Vec<u32> = input.next_as_iter().collect();

// `FastInput` has implementations of `FastParse` up to quintuples.
let (a, b, c, d, e) = input.next();
let sum: i32 = 0i32 + a + b + c + d + e;


// The `Str` type can be used to mix string slices with parsed data.
let (name, age): (Str, u8) = input.next();
// `Str` can be dereferenced into its contained string slice.
let name: &str = *name;

// Read all remaining lines and print them
for line in input.lines() {
    println!("{}", line);
}

No runtime deps