slice 0.0.4

slices for streams implementing `std::io::read` and `std::io::write`.
Documentation 
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

# slice.


create slices of io objects `std::io::Read` and `std::io::Write`.

if you have a file (or any other object), you can create a slice (or view) into some subset of it.

`IoSlice` impls both `std::io::Read` and `std::io::Write` when the source implements them (and only one if the source
only implements one).

## example usage.


```rust
use { std::fs::File, slice::IoSlice };


let source = File::open("/home/annie/data.png")?;
let start  = 10;
let length = 1000;


// create a slice into `home/annie/data.png`, consisting of bytes [10 .. 10 + 1000]
// of that file.
//
// `slice` impls both `std::io::Read` and `std::io::Write` because `source`
// does too.
let slice = IoSlice::new(source, start, length);


// use like any other `std::io::Read` or `std::io::Write`:
//
//     slice.read_to_string(...)?;
//     slice.read_exact(...)?;
//     slice.write_all(...)?;
//
//     writeln!(slice, "hello {}", name)?;
//
```