Trait axstd::io::Seek

pub trait Seek {
    // Required method
    fn seek(&mut self, pos: SeekFrom) -> Result<u64, AxError>;

    // Provided methods
    fn rewind(&mut self) -> Result<(), AxError> { ... }
    fn stream_position(&mut self) -> Result<u64, AxError> { ... }
}

The Seek trait provides a cursor which can be moved within a stream of bytes.

Required Methods

fn seek(&mut self, pos: SeekFrom) -> Result<u64, AxError>

Seek to an offset, in bytes, in a stream.

A seek beyond the end of a stream is allowed, but behavior is defined by the implementation.

If the seek operation completed successfully, this method returns the new position from the start of the stream. That position can be used later with SeekFrom::Start.

Provided Methods

fn rewind(&mut self) -> Result<(), AxError>

Rewind to the beginning of a stream.

This is a convenience method, equivalent to seek(SeekFrom::Start(0)).

fn stream_position(&mut self) -> Result<u64, AxError>

Returns the current seek position from the start of the stream.

This is equivalent to self.seek(SeekFrom::Current(0)).

Implementations on Foreign Types

impl Seek for File

fn seek(&mut self, pos: SeekFrom) -> Result<u64, AxError>

Implementors

impl Seek for axstd::fs::File

Available on crate feature fs only.