1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
|
# UTF-8 decode
This crates provides incremental UTF-8 decoders implementing the `Iterator` trait.
Thoses iterators are wrappers around `u8` bytes iterators.
## Decoder
The `Decoder` struct wraps `Iterator<Item = u8>` iterators.
You can use it, for instance, to decode `u8` slices.
```rust
extern crate utf8_decode;
use utf8_decode::Decoder;
fn main() -> std::io::Result<()> {
let bytes = [72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100, 33, 32, 240, 159, 140, 141];
let decoder = Decoder::new(bytes.iter().cloned());
let mut string = String::new();
for c in decoder {
string.push(c?);
}
println!("{}", string);
Ok(())
}
```
## UnsafeDecoder
The `UnsafeDecoder` wraps `Iterator<Item = std::io::Result<u8>>` iterators.
You can use it, for instance, to decode UTF-8 encoded files.
```rust
extern crate utf8_decode;
use std::fs::File;
use std::io::Read;
use utf8_decode::UnsafeDecoder;
fn main() -> std::io::Result<()> {
let file = File::open("examples/file.txt")?;
let decoder = UnsafeDecoder::new(file.bytes());
let mut string = String::new();
for c in decoder {
string.push(c?);
}
println!("{}", string);
Ok(())
}
```
## License
Licensed under either of
* Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
* MIT license ([LICENSE-MIT](LICENSE-MIT) or 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.
|
