Struct cap_async_std::fs::File

[+] Show declaration

pub struct File { /* fields omitted */ }

[−] Expand description

A reference to an open file on a filesystem.

This corresponds to async_std::fs::File.

Note that this File has no open or create methods. To open or create a file, you must first obtain a Dir containing the path, and then call Dir::open or Dir::create.

Implementations

impl File[−]

pub fn from_std(std: File) -> Self[−]

Constructs a new instance of Self from the given async_std::fs::File.

pub fn into_std(self) -> File[−]

Consumes self and returns an async_std::fs::File.

pub async fn sync_all<'_>(&'_ self) -> Result<()>[−]

Attempts to sync all OS-internal metadata to disk.

This corresponds to async_std::fs::File::sync_all.

pub async fn sync_data<'_>(&'_ self) -> Result<()>[−]

This function is similar to sync_all, except that it may not synchronize file metadata to a filesystem.

This corresponds to async_std::fs::File::sync_data.

pub async fn set_len<'_>(&'_ self, size: u64) -> Result<()>[−]

Truncates or extends the underlying file, updating the size of this file to become size.

This corresponds to async_std::fs::File::set_len.

pub async fn metadata<'_>(&'_ self) -> Result<Metadata>[−]

Queries metadata about the underlying file.

This corresponds to async_std::fs::File::metadata.

pub async fn set_permissions<'_>(&'_ self, perm: Permissions) -> Result<()>[−]

Changes the permissions on the underlying file.

This corresponds to async_std::fs::File::set_permissions.

Trait Implementations

impl AsRawFd for File[+]

[+] Show hidden undocumented items

fn as_raw_fd(&self) -> RawFd[−]

Extracts the raw file descriptor.

impl AsyncRead for File[+]

[+] Show hidden undocumented items

fn poll_read(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>,
    buf: &mut [u8]
) -> Poll<Result<usize>>[−]

Attempt to read from the AsyncRead into buf.

fn poll_read_vectored(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>,
    bufs: &mut [IoSliceMut<'_>]
) -> Poll<Result<usize>>[−]

Attempt to read from the AsyncRead into bufs using vectored IO operations.

impl<'_> AsyncRead for &'_ File[+]

[+] Show hidden undocumented items

fn poll_read(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>,
    buf: &mut [u8]
) -> Poll<Result<usize>>[−]

Attempt to read from the AsyncRead into buf.

fn poll_read_vectored(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>,
    bufs: &mut [IoSliceMut<'_>]
) -> Poll<Result<usize>>[−]

Attempt to read from the AsyncRead into bufs using vectored IO operations.

impl AsyncSeek for File[+]

[+] Show hidden undocumented items

fn poll_seek(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>,
    pos: SeekFrom
) -> Poll<Result<u64>>[−]

Attempt to seek to an offset, in bytes, in a stream.

impl<'_> AsyncSeek for &'_ File[+]

[+] Show hidden undocumented items

fn poll_seek(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>,
    pos: SeekFrom
) -> Poll<Result<u64>>[−]

Attempt to seek to an offset, in bytes, in a stream.

impl AsyncWrite for File[+]

[+] Show hidden undocumented items

fn poll_write(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>,
    buf: &[u8]
) -> Poll<Result<usize>>[−]

Attempt to write bytes from buf into the object.

fn poll_flush(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Result<()>>[−]

Attempt to flush the object, ensuring that any buffered data reach their destination.

fn poll_close(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Result<()>>[−]

Attempt to close the object.

fn poll_write_vectored(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>,
    bufs: &[IoSlice<'_>]
) -> Poll<Result<usize>>[−]

Attempt to write bytes from bufs into the object using vectored IO operations.

impl<'_> AsyncWrite for &'_ File[+]

[+] Show hidden undocumented items

fn poll_write(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>,
    buf: &[u8]
) -> Poll<Result<usize>>[−]

Attempt to write bytes from buf into the object.

fn poll_flush(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Result<()>>[−]

Attempt to flush the object, ensuring that any buffered data reach their destination.

fn poll_close(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Result<()>>[−]

Attempt to close the object.

fn poll_write_vectored(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>,
    bufs: &[IoSlice<'_>]
) -> Poll<Result<usize>>[−]

Attempt to write bytes from bufs into the object using vectored IO operations.

impl Debug for File[+]

[+] Show hidden undocumented items

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

Formats the value using the given formatter.

impl FromRawFd for File[+]

[+] Show hidden undocumented items

unsafe fn from_raw_fd(fd: RawFd) -> Self[−]

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

impl IntoRawFd for File[+]

[+] Show hidden undocumented items

fn into_raw_fd(self) -> RawFd[−]

Consumes this object, returning the raw underlying file descriptor.