use std::fs::File;
use std::io;
use std::sync::Arc;
pub trait ReadAt: Send + Sync {
fn read_exact_at(&self, buf: &mut [u8], off: u64) -> io::Result<()>;
fn len(&self) -> io::Result<u64>;
fn is_empty(&self) -> io::Result<bool> {
Ok(self.len()? == 0)
}
}
impl ReadAt for File {
fn read_exact_at(&self, buf: &mut [u8], off: u64) -> io::Result<()> {
crate::sys::read_exact_at(self, buf, off)
}
fn len(&self) -> io::Result<u64> {
Ok(self.metadata()?.len())
}
}
impl<R: ReadAt + ?Sized> ReadAt for Arc<R> {
fn read_exact_at(&self, buf: &mut [u8], off: u64) -> io::Result<()> {
(**self).read_exact_at(buf, off)
}
fn len(&self) -> io::Result<u64> {
(**self).len()
}
}
impl<R: ReadAt + ?Sized> ReadAt for Box<R> {
fn read_exact_at(&self, buf: &mut [u8], off: u64) -> io::Result<()> {
(**self).read_exact_at(buf, off)
}
fn len(&self) -> io::Result<u64> {
(**self).len()
}
}
pub struct Slice<R> {
inner: R,
off: u64,
len: u64,
}
impl<R: ReadAt> Slice<R> {
pub fn new(inner: R, off: u64, len: u64) -> Slice<R> {
Slice { inner, off, len }
}
}
impl<R: ReadAt> ReadAt for Slice<R> {
fn read_exact_at(&self, buf: &mut [u8], off: u64) -> io::Result<()> {
if off > self.len || buf.len() as u64 > self.len - off {
return Err(io::Error::new(
io::ErrorKind::UnexpectedEof,
format!(
"read of {} bytes at {off} exceeds the slice's {} bytes",
buf.len(),
self.len
),
));
}
self.inner.read_exact_at(buf, self.off + off)
}
fn len(&self) -> io::Result<u64> {
Ok(self.len)
}
}
#[cfg(test)]
mod tests {
use super::*;
struct Mem(Vec<u8>);
impl ReadAt for Mem {
fn read_exact_at(&self, buf: &mut [u8], off: u64) -> io::Result<()> {
let off = off as usize;
if off > self.0.len() || buf.len() > self.0.len() - off {
return Err(io::Error::new(io::ErrorKind::UnexpectedEof, "past the end"));
}
buf.copy_from_slice(&self.0[off..off + buf.len()]);
Ok(())
}
fn len(&self) -> io::Result<u64> {
Ok(self.0.len() as u64)
}
}
#[test]
fn a_slice_translates_and_bounds() {
let m = Mem((0u8..100).collect());
let s = Slice::new(m, 10, 20);
let mut b = [0u8; 5];
s.read_exact_at(&mut b, 0).unwrap();
assert_eq!(b, [10, 11, 12, 13, 14]);
s.read_exact_at(&mut b, 15).unwrap();
assert_eq!(b, [25, 26, 27, 28, 29]);
assert_eq!(s.len().unwrap(), 20);
assert!(s.read_exact_at(&mut b, 16).is_err(), "a slice must not read its neighbour");
assert!(s.read_exact_at(&mut b, u64::MAX - 2).is_err());
}
}