#io-write #io #io-read #file #read-write #file-offset #overlay

slice

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

4 releases

Uses old Rust 2015

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

#1383 in Filesystem

Download history 20/week @ 2023-12-04 60/week @ 2023-12-11 28/week @ 2023-12-18 2/week @ 2024-01-22 7/week @ 2024-02-12 9/week @ 2024-02-19 31/week @ 2024-02-26 13/week @ 2024-03-04 8/week @ 2024-03-11 18/week @ 2024-03-18

71 downloads per month
Used in 2 crates (via posy)

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