pub struct FileTruncator {
    worker: Option<WorkerThread<Result<File>>>,
}
Expand description

Truncates a file to length 0, in the background when possible.

Truncating a large file can result in a significant amount of IO when updating filesystem metadata. When possible, FileTruncator truncates a given file gradually over time to avoid competing with higher prioirty IO.

Fields§

§worker: Option<WorkerThread<Result<File>>>

Implementations§

source§

impl FileTruncator

source

pub fn new(file: File) -> Result<Self>

Creates an new FileTruncator to truncate the given file.

§Arguments
  • file - The file to truncate.
source

fn new_inner(timer: Box<dyn TimerTrait>, file: File) -> Result<Self>

source

pub fn take_file(self) -> Result<File>

Retrieves the underlying file, which is guaranteed to be truncated.

If this function is called while the background worker thread has not finished, it may block briefly while stopping the background worker.

Trait Implementations§

source§

impl Drop for FileTruncator

source§

fn drop(&mut self)

Executes the destructor for this type. Read more

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.