#io #read #readline #scan #scanf

text_io

really simple to use panicking input functions

16 releases

0.1.12 Jul 29, 2022
0.1.10 Feb 17, 2022
0.1.9 Jul 29, 2021
0.1.8 Jan 14, 2020
0.1.0 May 12, 2015

#80 in Text processing

Download history 5852/week @ 2023-01-31 3987/week @ 2023-02-07 4512/week @ 2023-02-14 4797/week @ 2023-02-21 4037/week @ 2023-02-28 4937/week @ 2023-03-07 4493/week @ 2023-03-14 5240/week @ 2023-03-21 4295/week @ 2023-03-28 4076/week @ 2023-04-04 4416/week @ 2023-04-11 5062/week @ 2023-04-18 6063/week @ 2023-04-25 4836/week @ 2023-05-02 3508/week @ 2023-05-09 4235/week @ 2023-05-16

19,586 downloads per month
Used in 101 crates (89 directly)

MIT/Apache

12KB
174 lines

[Build Status Latest Version

You can use either the read! macro to read a single value and return it, or the scan! macro to read one or more values into variables. Both macros can also read from a file or from memory. The read! macro can take any type that implements Iterator<Item=u8> as an optional third argument, and the scan! macro's arguments can be prefixed with iter => where iter implements Iterator<Item=u8>.

Examples

scan! macro

use text_io::scan;

// reading from a string source
let i: i32;
scan!("<b>12</b>".bytes() => "<b>{}</b>", i);
assert_eq!(i, 12);

// reading multiple values from stdio
let a: i32;
let b: &mut u8 = &mut 5;
scan!("{}, {}", a, *b);

read! macro

use text_io::read;

// read until a whitespace and try to convert what was read into an i32
let i: i32 = read!();

// read until a whitespace (but not including it)
let word: String = read!(); // same as read!("{}")

// read until a newline (but not including it)
let line: String = read!("{}\n");

// expect the input "<b><i>" or panic
// read until the next "<" and return that.
// expect the input "/i></b>"
let stuff: String = read!("<b><i>{}</i></b>");

// reading from files
use std::io::Read;
let mut file = std::fs::File::open("tests/answer.txt").unwrap().bytes().map(|ch| ch.unwrap());
let val: i32 = read!("The answer is {}!!!11einself\n", file);

// reading from strings
let val: i32 = read!("Number: {}", "Number: 99".bytes());

No runtime deps