Struct AtomicFile 

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

The streaming form of write_file: the bytes go into a sibling of the target, commit puts it in place in one step (readers see the old file or all of the new one); dropped without commit, the sibling is removed and the target is unchanged. Checked and routed like write_file when it is created. OS paths: an exclusive “NAME.tmp-PID-SEQ-TIME” beside the file, fsync and rename (Linux keeps the old file’s access bits; the browser: in memory until commit). Mounts: a “NAME.tmp-..” file of the mount, renamed by the provider (one without rename gets the whole file written); a provider whose rename cannot replace a file (atomic_rename() == false, content://) gets the bytes written in place at commit.

Implementations

impl AtomicFile

pub fn create(path: &str) -> Option<AtomicFile>

a writer of path (None: refused, a folder, an invalid name, or the sibling could not be created)

pub fn write_at(&self, off: u64, data: &[u8]) -> Option<usize>

bytes written at off (the file grows as needed), None on an error

pub fn commit(self) -> bool

put the written file in place -> false: the target is unchanged, the sibling gone

Trait Implementations

impl Drop for AtomicFile

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

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

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.