#byte-range #file #read-file #file-io #region #contiguous #io-read

file-region

Encapsulates a contiguous byte range of a file

1 unstable release

0.1.0 Sep 12, 2024

#1293 in Filesystem

MIT/Apache

8KB
155 lines

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.

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(())
}

No runtime deps