Skip to content
a rusty `scanf` (`scan!`) and inverse of `print!` (`read!`)
Branch: master
Clone or download
Latest commit 22a6a04 Jan 14, 2020
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples Migrate `text_io` itself to Rust 2018 Nov 7, 2019
failing-examples add newline at eof and remove old comment Nov 26, 2016
src Rustfmt Jan 14, 2020
tests rustfmt Apr 18, 2019
.gitignore add failing examples, add a test for panic Nov 25, 2016
.travis.yml remove nightly Jan 13, 2016
Cargo.toml Version bump Jan 14, 2020
LICENSE Update LICENSE Oct 16, 2017 Update docs Nov 7, 2019

Build Status Latest Version Clippy Linting Result

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>.


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());
You can’t perform that action at this time.