# utf8-read
A UTF8 character stream reader using a provided std::io::Read byte stream reader, that provides a stream of UTF8 characters; the underlying stream reader can be a stop-start stream such as a TCP stream, where a read() returning 0 does not indicate end-of-stream.
The UTF8 reader provides a step above std::fs::read_to_string function; for reading short UTF8 files that function is a better approach.
This crate is in beta; it is used in a small number of applications,
and the functionality is mature; the API is stable, but may be enhanced.
## Usage
Add this to your `Cargo.toml`:
```toml
[dependencies]
utf8-read = "0.5.0"
```
## Releases
Release notes are available in [RELEASES.md](RELEASES.md).
## License
Licensed under either of
* [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0)
* [MIT license](http://opensource.org/licenses/MIT)
at your option.
### Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.