Don't forget to add the plugin to your crate:

```rust

[macrouse] extern crate textio;

```

If you are on nightly and wish to parse multiple values in one read invocation, you need to replace the import with

```rust

![feature(plugin)]

![plugin(text_io)]

```

and enable the cargo feature nightly

toml [dependencies.text_io] version = "*" features = ["nightly"]

Examples

```rust // 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 "" or panic // read until the next "<" and return that. // expect the input "/i>" let stuff: String = read!("{}");