file-region 0.1.0

Encapsulates a contiguous byte range of a file
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

# file-region

This crate provides a `FileRegion` type which encapsulates a particular region of a `File`.

## Example

You can find this example at `examples/basic.rs` and run it with `cargo run --example basic`.

```rust
use file_region::FileRegion;
use std::io::{Read, Seek, SeekFrom, Write};
use tempfile::tempfile;

fn main() -> std::io::Result<()> {
    let mut file = tempfile()?;
    file.write_all(b"Hello, FileRegion.")?;

    let mut region = FileRegion::new(&file, 7..16);
    let mut buffer = [0; 9];
    region.read(0, &mut buffer)?;
    assert_eq!(&buffer, b"FileRegio");

    region.write(0, b"01234")?;

    let mut content = String::new();
    file.seek(SeekFrom::Start(0))?;
    file.read_to_string(&mut content)?;
    assert_eq!(content, "Hello, 01234egion.");

    Ok(())
}
```