#io #slice #file #offset #overlay

slice

slices for streams implementing std::io::read and std::io::write

4 releases

0.0.4 Aug 7, 2018
0.0.3 Apr 2, 2018
0.0.2 Aug 14, 2017
0.0.1 Apr 27, 2017

#18 in Filesystem

Download history 3/week @ 2018-07-09 7/week @ 2018-07-16 8/week @ 2018-07-23 3870/week @ 2018-07-30 3787/week @ 2018-08-06 6133/week @ 2018-08-13 6268/week @ 2018-08-20 6515/week @ 2018-08-27 6762/week @ 2018-09-03 6925/week @ 2018-09-10 6836/week @ 2018-09-17 6545/week @ 2018-09-24 5851/week @ 2018-10-01

3,043 downloads per month

MIT/Apache

11KB
134 lines

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.

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)?;
//

lib.rs:

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.

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)?;
//

No runtime deps