2 unstable releases
0.2.0 | Oct 4, 2019 |
---|---|
0.1.0 | Sep 29, 2019 |
#1687 in Data structures
18KB
196 lines
ensured_bufreader
Overview
ensured_bufreader
provides EnsuredBufReader
that ensured length bytes in its buffer if it can read from underlying reader.
std::io::BufReader
doesn't read bytes from underlying reader if it has buffered bytes.
This behavior is better if you need buffering for performance.
But, if you need buffering for algorithm such as peeking N bytes, BufReader
donesn't ensure N bytes in its buffer.
If there are too few bytes in buffer when .fill_buf()
called, EnsuredBufReader
tries to read additional bytes from underlying reader and keep .fill_buf()?.len() > ensured
.
Comparition with other crates
buffered-reader
provides same functionality as this crate.
But there is some differences.
ensured_bufreader |
buffered-reader = "0.10.0" |
|
---|---|---|
Implementation strategy | Uses standard trait BufRead and simple wrapper struct |
Provides new trait and some implementaions |
When returns error | Immediately | Saved and returned when read position error occuered |
License | MIT or Apache-2.0 (permissive) | GPL-3.0 (copyleft) |
License
ensured_bufreader
is distributed under the terms of both the MIT license and the Apache License (Version 2.0).
See LICENSE-APACHE and LICENSE-MIT.