Struct File

pub struct File(/* private fields */);

Implementations

impl File

pub fn open(path: &UnixStr) -> Result<Self>

Opens a file with default options

Errors

Operating system errors ond finding and reading files

pub const unsafe fn from_raw_fd(fd: RawFd) -> Self

Create a File from a raw fd

Safety

The fd is valid and is not duplicated. Duplication is bad since the fd will be closed when this File is dropped

pub fn set_nonblocking(&self) -> Result<()>

Set this File to be non-blocking. This will result in for example read expecting a certain number of bytes to fail with EAGAIN if that data isn’t available.

Errors

Errors making the underlying syscalls

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

Get file metadata for this open File

Errors

Os errors making the stat-syscall

pub fn copy(&self, dest: &UnixStr) -> Result<Self>

Copies src to dest, can be used to move files. Will overwrite anything currently at dest. Returns a handle to the new file.

Errors

Os errors relating to file access

Trait Implementations

impl AsRawFd for File

fn as_raw_fd(&self) -> RawFd

impl Read for File

fn read(&mut self, buf: &mut [u8]) -> Result<usize>

Read into to provided buffer

fn read_to_end(&mut self, buf: &mut Vec<u8>) -> Result<usize>

Reads to the end of this Reader,

fn read_to_string(&mut self, buf: &mut String) -> Result<usize>

Reads to the end of the provided buffer

fn read_exact(&mut self, buf: &mut [u8]) -> Result<()>

Reads exactly enough bytes to fill the buffer

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Get this reader by mut ref

impl Write for File

fn write(&mut self, buf: &[u8]) -> Result<usize>

Tries to write the contents of the provided buffer into this writer returning how many bytes were written.

fn flush(&mut self) -> Result<()>

Flushes this Writer

fn write_all(&mut self, buf: &[u8]) -> Result<()>

Writes the full buffer into this Writer

fn write_fmt(&mut self, fmt: Arguments<'_>) -> Result<()>

Writes format arguments into this Writer

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Get this Writer as a mutable reference