Struct AtomicFileOutput 

pub struct AtomicFileOutput { /* private fields */ }

将完整结果先写入同目录临时文件，再原子替换目标文件。

Examples

use easypdf_core::AtomicFileOutput;

AtomicFileOutput::new("/tmp/output.pdf")
    .write(b"%PDF-1.4 ...");

Implementations

impl AtomicFileOutput

pub fn new(target: impl Into<PathBuf>) -> Self

创建原子文件输出目标。

pub fn target(&self) -> &Path

返回最终目标路径。

pub fn write(&self, bytes: &[u8]) -> Result<()>

原子写入完整字节内容。

使用 std::fs::File::sync_all 在重命名前将数据和元数据 刷新到持久存储。

Errors

创建目录、写入、同步或替换失败时返回错误。

pub fn write_with_fsync(&self, data: &[u8]) -> Result<()>

使用显式 fsync 写入数据，然后原子替换目标。

在 macOS 上映射到 fcntl(F_FULLFSYNC)（通过 Rust 的 std::fs::File::sync_all），在 Linux 上映射到 fdatasync， 在 Windows 上映射到 FlushFileBuffers。全部通过安全 Rust。

Errors

任何阶段的 I/O 失败时返回错误。

pub fn write_with_backup(&self, data: &[u8]) -> Result<()>

备份现有文件（如果有），然后原子写入新数据。

写入成功则移除备份。写入失败则将备份恢复到原始路径。

备份创建在同目录的 <target>.bak。

Errors

备份创建、写入或恢复失败时返回错误。

pub fn atomic_replace<F>(&self, writer: F) -> Result<()>

where F: FnOnce(&mut Vec<u8>) -> Result<()>,

基于回调的原子写入：调用方填充缓冲区，然后缓冲区 被原子地写入目标。

此模式避免了在内存中两次持有整个输出 （一次用于调用方的缓冲区，一次用于写入调用）。

Errors

回调失败或原子写入失败时返回错误。

Examples

use easypdf_core::AtomicFileOutput;

AtomicFileOutput::new("/tmp/output.pdf").atomic_replace(|buf| {
    buf.extend_from_slice(b"%PDF-1.4 ...");
    Ok(())
}).unwrap();

Trait Implementations

impl Clone for AtomicFileOutput

fn clone(&self) -> AtomicFileOutput

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AtomicFileOutput

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

Formats the value using the given formatter.