uuidtoa
=======
Optimized serialization of hyphenated UUID ASCII representation to `io::Write`
sinks.
The two functions exported by this crate are `write_lower` and `write_upper`;
here are their signatures:
```rust
fn write_lower<W: io::Write>(io: &mut W, uuid: &Uuid) -> io::Result<usize>;
fn write_upper<W: io::Write>(io: &mut W, uuid: &Uuid) -> io::Result<usize>;
```
An example of writing this out to a buffer would be
```rust
let uuid = Uuid::from_str("e098d1f6-7e49-4c34-99f6-e9c6cef8fcce").unwrap();
let mut buf: Vec<u8> = Vec::with_capacity(36);
write_lower(&mut buf, &uuid).unwrap();
```
This performs approximately 10x better than the equivalent `fmt::Display` impl
from the _uuid_ crate.
```rust
let uuid = Uuid::from_str("e098d1f6-7e49-4c34-99f6-e9c6cef8fcce").unwrap();
let buf = format!("{}", uuid.hyphenated());
```
The benchmarks from these two approaches are as follows.
```
test benches::bench_fmt ... bench: 522 ns/iter (+/- 6)
test benches::bench_lower ... bench: 45 ns/iter (+/- 0)
```
To run them for yourself, the bench feature and nightly compiler should be used.
```sh
cargo bench --feature bench
```