Crate token_read

This is a simple crate that allows for easy parsing of whitespace delimited files.

It is primarily intended for competitive programming, where such files are commonly used as inputs due to being easy to parse in C and C++. This crate aims to bring this ease to Rust.

Sample usage

Input

42
Benjamin 2536000
0 1 1 2 3 5 8 13 21 34

Code

use std::io::stdin;

use anyhow::Result;
use token_read::TokenReader;

fn main() -> Result<()> {
    let mut input = TokenReader::new(stdin().lock());

    let (n,): (usize,) = input.line()?; // Read a single value
    let (name, points): (String, u64) = input.line()?; // Read several values
    let values: Vec<u64> = input.line()?; // Read an array of values
    let tuples: Vec<(u32, f64)> = input.take(3).collect::<Result<_, _>>()?; // Read several lines of values
     
    // Do some processing

    Ok(())
}

Modules

impls

Types (currently errors) related to specific implementations of FromTokens

Structs

Take

An iterator returned from TokenReader::take.

TokenReader

This struct wraps a BufReader to allow easy parsing of whitespace delimited files.

Enums

ParseTokenPatternError

An error returned when parsing a constant amount of tokens.

ReadLineError

An error returned from TokenReader::line_raw.

ReadTokensError

An error returned from TokenReader::line.

Traits

FromTokens

A trait for types parsable from an iterator of whitespace delimited tokens.

LineCount

A trait for various types than can represent a number of lines.

ToTokens

A trait for types that can be used to create an iterator of tokens.