Struct photonio_uring::fs::File

pub struct File(_);

A reference to an open file.

This type is an async version of std::fs::File.

Implementations

impl File

pub async fn open<P: AsRef<Path>>(path: P) -> Result<Self>

Opens a file in read-only mode.

See also std::fs::File::open.

pub async fn create<P: AsRef<Path>>(path: P) -> Result<Self>

Opens a file in write-only mode.

This function will create a file if it does not exist, and will truncate it if it does.

See also std::fs::File::create.

pub async fn metadata(&self) -> Result<Metadata>

Returns the metadata about this file.

See also std::fs::File::metadata.

pub async fn set_len(&self, size: u64) -> Result<()>

Truncates or extends the size of this file.

See also std::fs::File::set_len.

pub async fn sync_all(&self) -> Result<()>

Synchronizes all modified data of this file to disk.

See also std::fs::File::sync_all.

pub async fn sync_data(&self) -> Result<()>

This function is similiar to Self::sync_all, except that it might not synchronize metadata.

See also std::fs::File::sync_data.

Trait Implementations

impl AsRawFd for File

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.

impl Debug for File

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromRawFd for File

unsafe fn from_raw_fd(fd: RawFd) -> Self

Constructs a new instance of Self from the given raw file descriptor.

impl Read for File

type Read<'a> = impl Future<Output = Result<usize, Error>> + 'a

A future that resolves to the result of Self::read.

fn read<'a>(&'a mut self, buf: &'a mut [u8]) -> Self::Read<'a>

Reads some bytes from this object into buf.

impl ReadAt for File

type ReadAt<'a> = impl Future<Output = Result<usize, Error>> + 'a

A future that resolves to the result of Self::read_at.

fn read_at<'a>(&'a self, buf: &'a mut [u8], pos: u64) -> Self::ReadAt<'a>

Reads some bytes from this object at pos into buf.

impl Seek for File

type Seek = impl Future<Output = Result<u64, Error>>

A future that resolves to the result of Self::seek.

fn seek(&mut self, pos: SeekFrom) -> Self::Seek

Seeks to a given position in this object.

impl Write for File

type Write<'a> = impl Future<Output = Result<usize, Error>> + 'a

A future that resolves to the result of Self::write.

fn write<'a>(&'a mut self, buf: &'a [u8]) -> Self::Write<'a>

Writes some bytes from buf into this object.

impl WriteAt for File

type WriteAt<'a> = impl Future<Output = Result<usize, Error>> + 'a

A future that resolves to the result of Self::write_at.

fn write_at<'a>(&'a self, buf: &'a [u8], pos: u64) -> Self::WriteAt<'a>

Writes some bytes from buf into this object at pos.