Struct cap_std_ext::tempfile::LinkableTempfile

pub struct LinkableTempfile<'p, 'd> { /* private fields */ }

A temporary file that may be given a persistent name.

Implementations

impl<'p, 'd> LinkableTempfile<'p, 'd>

pub fn replace_with_perms(self, permissions: Permissions) -> Result<()>

Write the file to its destination with the chosen permissions.

pub fn replace_contents_using_perms(
    self,
    contents: impl AsRef<[u8]>,
    permissions: Permissions
) -> Result<()>

Write the given contents to the file to its destination with the chosen permissions.

pub fn replace_contents(self, contents: impl AsRef<[u8]>) -> Result<()>

Write the given contents to the file to its destination with the chosen permissions.

pub fn replace(self) -> Result<()>

Write the file to its destination.

If a file exists at the destination already, and no override permissions are set, the permissions will be set to match the destination. Otherwise, a conservative default of 0o600 i.e. rw------- will be used.

pub fn emplace(self) -> Result<()>

Write the file to its destination, erroring out if there is an extant file.

Methods from Deref<Target = File>

pub fn sync_all(&self) -> Result<(), Error>

Attempts to sync all OS-internal metadata to disk.

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

pub fn sync_data(&self) -> Result<(), Error>

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

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

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

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

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

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

Queries metadata about the underlying file.

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

pub fn try_clone(&self) -> Result<File, Error>

Creates a new File instance that shares the same underlying file handle as the existing File instance.

This corresponds to std::fs::File::try_clone.

pub fn set_permissions(&self, perm: Permissions) -> Result<(), Error>

Changes the permissions on the underlying file.

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

Trait Implementations

impl<'p, 'd> Debug for LinkableTempfile<'p, 'd>

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

Formats the value using the given formatter.

impl<'p, 'd> Deref for LinkableTempfile<'p, 'd>

type Target = File

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'p, 'd> DerefMut for LinkableTempfile<'p, 'd>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'p, 'd> Write for LinkableTempfile<'p, 'd>

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

Write a buffer into this writer, returning how many bytes were written.

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

Flush this output stream, ensuring that all intermediately buffered contents reach their destination.

fn write_vectored(&mut self, bufs: &[IoSlice<'_>]) -> Result<usize, Error>

Like write, except that it writes from a slice of buffers.

fn is_write_vectored(&self) -> bool

🔬 This is a nightly-only experimental API. (can_vector)

Determines if this Writer has an efficient write_vectored implementation.

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

Attempts to write an entire buffer into this writer.

fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>

🔬 This is a nightly-only experimental API. (write_all_vectored)

Attempts to write multiple buffers into this writer.

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

Writes a formatted string into this writer, returning any error encountered.

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

Creates a “by reference” adapter for this instance of Write.