Trait std::os::windows::fs::FileExt1.15.0 [] [src]

pub trait FileExt {
    fn seek_read(&self, buf: &mut [u8], offset: u64) -> Result<usize>;
    fn seek_write(&self, buf: &[u8], offset: u64) -> Result<usize>;
}

Windows-specific extensions to File

Required Methods

Seeks to a given position and reads a number of bytes.

Returns the number of bytes read.

The offset is relative to the start of the file and thus independent from the current cursor. The current cursor is affected by this function, it is set to the end of the read.

Reading beyond the end of the file will always return with a length of 0.

Note that similar to File::read, it is not an error to return with a short read. When returning from such a short read, the file pointer is still updated.

Seeks to a given position and writes a number of bytes.

Returns the number of bytes written.

The offset is relative to the start of the file and thus independent from the current cursor. The current cursor is affected by this function, it is set to the end of the write.

When writing beyond the end of the file, the file is appropiately extended and the intermediate bytes are left uninitialized.

Note that similar to File::write, it is not an error to return a short write. When returning from such a short write, the file pointer is still updated.

Implementors