Struct scanner_rust::ScannerAscii

pub struct ScannerAscii<R: Read> { /* fields omitted */ }

A simple text scanner which can parse primitive types and strings using ASCII.

Implementations

impl<R: Read> ScannerAscii<R>

pub fn new(reader: R) -> ScannerAscii<R>

Create a scanner from a reader.

extern crate scanner_rust;

use std::io;

use scanner_rust::ScannerAscii;

let mut sc = ScannerAscii::new(io::stdin());

impl ScannerAscii<File>

pub fn scan_path<P: AsRef<Path>>(
    path: P
) -> Result<ScannerAscii<File>, ScannerError>

Create a scanner to read data from a file by its path.

extern crate scanner_rust;

use scanner_rust::ScannerAscii;

let mut sc = ScannerAscii::scan_path("Cargo.toml").unwrap();

impl<R: Read> ScannerAscii<R>

pub fn next_char(&mut self) -> Result<Option<char>, ScannerError>

Read the next char. If the data is not a correct char, it will return a Ok(Some(REPLACEMENT_CHARACTER)) which is �. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::ScannerAscii;

let mut sc = ScannerAscii::new("5 c ab".as_bytes());

assert_eq!(Some('5'), sc.next_char().unwrap());
assert_eq!(Some(' '), sc.next_char().unwrap());
assert_eq!(Some('c'), sc.next_char().unwrap());
assert_eq!(Some(' '), sc.next_char().unwrap());
assert_eq!(Some('a'), sc.next_char().unwrap());
assert_eq!(Some('b'), sc.next_char().unwrap());
assert_eq!(None, sc.next_char().unwrap());

pub fn next_line(&mut self) -> Result<Option<String>, ScannerError>

Read the next line but not include the tailing line character (or line chracters like CrLf(\r\n)). If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::ScannerAscii;

let mut sc = ScannerAscii::new("123 456\r\n789 \n\n ab ".as_bytes());

assert_eq!(Some("123 456".into()), sc.next_line().unwrap());
assert_eq!(Some("789 ".into()), sc.next_line().unwrap());
assert_eq!(Some("".into()), sc.next_line().unwrap());
assert_eq!(Some(" ab ".into()), sc.next_line().unwrap());

pub fn next_line_raw(&mut self) -> Result<Option<Vec<u8>>, ScannerError>

Read the next line include the tailing line character (or line chracters like CrLf(\r\n)) without validating ASCII. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::ScannerAscii;

let mut sc = ScannerAscii::new("123 456\r\n789 \n\n ab ".as_bytes());

assert_eq!(Some("123 456".into()), sc.next_line_raw().unwrap());
assert_eq!(Some("789 ".into()), sc.next_line_raw().unwrap());
assert_eq!(Some("".into()), sc.next_line_raw().unwrap());
assert_eq!(Some(" ab ".into()), sc.next_line_raw().unwrap());

pub fn drop_next_line(&mut self) -> Result<Option<usize>, ScannerError>

Drop the next line but not include the tailing line character (or line chracters like CrLf(\r\n)). If there is nothing to read, it will return Ok(None). If there are something to read, it will return Ok(Some(i)). The i is the length of the dropped line.

extern crate scanner_rust;

use scanner_rust::ScannerAscii;

let mut sc = ScannerAscii::new("123 456\r\n789 \n\n ab ".as_bytes());

assert_eq!(Some(7), sc.drop_next_line().unwrap());
assert_eq!(Some("789 ".into()), sc.next_line().unwrap());
assert_eq!(Some(0), sc.drop_next_line().unwrap());
assert_eq!(Some(" ab ".into()), sc.next_line().unwrap());
assert_eq!(None, sc.drop_next_line().unwrap());

impl<R: Read> ScannerAscii<R>

pub fn skip_whitespaces(&mut self) -> Result<bool, ScannerError>

Skip the next whitespaces (javaWhitespace). If there is nothing to read, it will return Ok(false).

extern crate scanner_rust;

use scanner_rust::ScannerAscii;

let mut sc = ScannerAscii::new("1 2   c".as_bytes());

assert_eq!(Some('1'), sc.next_char().unwrap());
assert_eq!(Some(' '), sc.next_char().unwrap());
assert_eq!(Some('2'), sc.next_char().unwrap());
assert_eq!(true, sc.skip_whitespaces().unwrap());
assert_eq!(Some('c'), sc.next_char().unwrap());
assert_eq!(false, sc.skip_whitespaces().unwrap());

pub fn next(&mut self) -> Result<Option<String>, ScannerError>

Read the next token separated by whitespaces. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::ScannerAscii;

let mut sc = ScannerAscii::new("123 456\r\n789 \n\n ab ".as_bytes());

assert_eq!(Some("123".into()), sc.next().unwrap());
assert_eq!(Some("456".into()), sc.next().unwrap());
assert_eq!(Some("789".into()), sc.next().unwrap());
assert_eq!(Some("ab".into()), sc.next().unwrap());
assert_eq!(None, sc.next().unwrap());

pub fn next_raw(&mut self) -> Result<Option<Vec<u8>>, ScannerError>

Read the next token separated by whitespaces without validating ASCII. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::ScannerAscii;

let mut sc = ScannerAscii::new("123 456\r\n789 \n\n ab ".as_bytes());

assert_eq!(Some("123".into()), sc.next_raw().unwrap());
assert_eq!(Some("456".into()), sc.next_raw().unwrap());
assert_eq!(Some("789".into()), sc.next_raw().unwrap());
assert_eq!(Some("ab".into()), sc.next_raw().unwrap());
assert_eq!(None, sc.next_raw().unwrap());

pub fn drop_next(&mut self) -> Result<Option<usize>, ScannerError>

Drop the next token separated by whitespaces. If there is nothing to read, it will return Ok(None). If there are something to read, it will return Ok(Some(i)). The i is the length of the dropped line.

extern crate scanner_rust;

use scanner_rust::ScannerAscii;

let mut sc = ScannerAscii::new("123 456\r\n789 \n\n ab ".as_bytes());

assert_eq!(Some(3), sc.drop_next().unwrap());
assert_eq!(Some("456".into()), sc.next().unwrap());
assert_eq!(Some(3), sc.drop_next().unwrap());
assert_eq!(Some("ab".into()), sc.next().unwrap());
assert_eq!(None, sc.drop_next().unwrap());

impl<R: Read> ScannerAscii<R>

pub fn next_u8(&mut self) -> Result<Option<u8>, ScannerError>

Read the next token separated by whitespaces and parse it to a u8 value. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::Scanner;

let mut sc = Scanner::new("1 2".as_bytes());

assert_eq!(Some(1), sc.next_u8().unwrap());
assert_eq!(Some(2), sc.next_u8().unwrap());

pub fn next_u16(&mut self) -> Result<Option<u16>, ScannerError>

Read the next token separated by whitespaces and parse it to a u16 value. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::Scanner;

let mut sc = Scanner::new("1 2".as_bytes());

assert_eq!(Some(1), sc.next_u16().unwrap());
assert_eq!(Some(2), sc.next_u16().unwrap());

pub fn next_u32(&mut self) -> Result<Option<u32>, ScannerError>

Read the next token separated by whitespaces and parse it to a u32 value. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::Scanner;

let mut sc = Scanner::new("1 2".as_bytes());

assert_eq!(Some(1), sc.next_u32().unwrap());
assert_eq!(Some(2), sc.next_u32().unwrap());

pub fn next_u64(&mut self) -> Result<Option<u64>, ScannerError>

Read the next token separated by whitespaces and parse it to a u64 value. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::Scanner;

let mut sc = Scanner::new("1 2".as_bytes());

assert_eq!(Some(1), sc.next_u64().unwrap());
assert_eq!(Some(2), sc.next_u64().unwrap());

pub fn next_u128(&mut self) -> Result<Option<u128>, ScannerError>

Read the next token separated by whitespaces and parse it to a u128 value. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::Scanner;

let mut sc = Scanner::new("1 2".as_bytes());

assert_eq!(Some(1), sc.next_u128().unwrap());
assert_eq!(Some(2), sc.next_u128().unwrap());

pub fn next_usize(&mut self) -> Result<Option<usize>, ScannerError>

Read the next token separated by whitespaces and parse it to a usize value. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::Scanner;

let mut sc = Scanner::new("1 2".as_bytes());

assert_eq!(Some(1), sc.next_usize().unwrap());
assert_eq!(Some(2), sc.next_usize().unwrap());

pub fn next_i8(&mut self) -> Result<Option<i8>, ScannerError>

Read the next token separated by whitespaces and parse it to a i8 value. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::Scanner;

let mut sc = Scanner::new("1 2".as_bytes());

assert_eq!(Some(1), sc.next_i8().unwrap());
assert_eq!(Some(2), sc.next_i8().unwrap());

pub fn next_i16(&mut self) -> Result<Option<i16>, ScannerError>

Read the next token separated by whitespaces and parse it to a i16 value. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::Scanner;

let mut sc = Scanner::new("1 2".as_bytes());

assert_eq!(Some(1), sc.next_i16().unwrap());
assert_eq!(Some(2), sc.next_i16().unwrap());

pub fn next_i32(&mut self) -> Result<Option<i32>, ScannerError>

Read the next token separated by whitespaces and parse it to a i32 value. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::Scanner;

let mut sc = Scanner::new("1 2".as_bytes());

assert_eq!(Some(1), sc.next_i32().unwrap());
assert_eq!(Some(2), sc.next_i32().unwrap());

pub fn next_i64(&mut self) -> Result<Option<i64>, ScannerError>

Read the next token separated by whitespaces and parse it to a i64 value. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::Scanner;

let mut sc = Scanner::new("1 2".as_bytes());

assert_eq!(Some(1), sc.next_i64().unwrap());
assert_eq!(Some(2), sc.next_i64().unwrap());

pub fn next_i128(&mut self) -> Result<Option<i128>, ScannerError>

Read the next token separated by whitespaces and parse it to a i128 value. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::Scanner;

let mut sc = Scanner::new("1 2".as_bytes());

assert_eq!(Some(1), sc.next_i128().unwrap());
assert_eq!(Some(2), sc.next_i128().unwrap());

pub fn next_isize(&mut self) -> Result<Option<isize>, ScannerError>

Read the next token separated by whitespaces and parse it to a isize value. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::Scanner;

let mut sc = Scanner::new("1 2".as_bytes());

assert_eq!(Some(1), sc.next_isize().unwrap());
assert_eq!(Some(2), sc.next_isize().unwrap());

pub fn next_f32(&mut self) -> Result<Option<f32>, ScannerError>

Read the next token separated by whitespaces and parse it to a f32 value. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::Scanner;

let mut sc = Scanner::new("1 2.5".as_bytes());

assert_eq!(Some(1.0), sc.next_f32().unwrap());
assert_eq!(Some(2.5), sc.next_f32().unwrap());

pub fn next_f64(&mut self) -> Result<Option<f64>, ScannerError>

Read the next token separated by whitespaces and parse it to a f64 value. If there is nothing to read, it will return Ok(None).

extern crate scanner_rust;

use scanner_rust::Scanner;

let mut sc = Scanner::new("1 2.5".as_bytes());

assert_eq!(Some(1.0), sc.next_f64().unwrap());
assert_eq!(Some(2.5), sc.next_f64().unwrap());

Trait Implementations

impl<R: Read> Debug for ScannerAscii<R>

fn fmt(&self, formatter: &mut Formatter) -> Result

Formats the value using the given formatter.