EasyIO.rs
Two structs InputReader
and OutputWriter
for fast and convenient IO in Rust.
The main use of these structs is in competitive programming or Kattis style problems. Reading particularly numbers via io::stdin()
is not very convenient. In competitive programming you want to be able to easily get the next number or word in the stream since you know the exact format of the input before hand. The InputReader
struct makes that trivial while also being fast.
Regular output in Rust via println!()
can also be problematic since it is line buffered. This can make output can be surprisingly slow. The OutputWriter
struct buffers all output which results in a much better performance.
To use these in competitive programming simply download input_reader.rs
or output_reader.rs
. Put them in the same folder as your solution and import it like below.
This was inspired by this amazing Java class but written completely separately.
InputReader
Usage
// import it
use InputReader;
:warning: Limitations
This struct sacrifices some functionality/correctness for performance and convenience:
- Results are unwrapped internally so that the API is much simpler. In competitive programming you will not recover from any IO error anyway.
- UTF8 strings are not supported. The
InputReader
will treat each byte in the input source as a separate character. This is a significant speed up and in competitive programming only ascii is almost always used anyway. - It will not do any validation on the size of numbers before trying to fit them in a
u8
for example. This is also fine for competitive programming since number bounds are usually given. - Only parses decimal notation for numbers, not hexadecimal for example.
- It will not parse special float values like
NaN
orInfinity
.
Public methods
Constructors
// Constructs an InputReader which reads from stdin.
new
// Constructs an InputReader which reads from the file at the given path.
from_file
// Constructs an InputReader that reads from the given reader.
from_reader
Reader methods
The following methods are pretty self-explanatory. They read the next thing from the input source.
// Note that it will not include the newline char
next_line next_usize
The two string methods return a &str
instead of a String
for optimization reasons. If you need a String
that you own you can copy it by doing input.next_word().to_string()
.
Other instance methods
// Returns true if there is more data to be read from the input source.
has_more // Changes the internal buffer size. Default: 2^16 bytes
// Will panic if shrinking the buffer would cause data loss.
set_buf_size
OutputWriter
Usage
// import it
use OutputWriter;
Public methods
This class implements the Write
trait. This is mostly so we can utilize the write!
and writeln!
macros but this means several more methods are available on the struct. See documentation here.
Constructors
// Constructs an OutputWriter which writes to stdout.
new
// Constructs an OutputWriter which writes to the file at the given path.
from_file
// Constructs an OutputWriter that writes to the given writer.
from_writer
Instance methods
// Writes the string to the output source.
print
// Convenience method for writing the given string with a newline appended.
println