Struct WriteBuilder 

pub struct WriteBuilder<'et> { /* private fields */ }

写入构建器

Implementations

impl<'et> WriteBuilder<'et>

pub fn tag(self, tag: impl Into<String>, value: impl Into<String>) -> Self

设置标签值

pub fn tag_id(self, tag: TagId, value: impl Into<String>) -> Self

设置标签值（使用 TagId）

pub fn tags(self, tags: HashMap<impl Into<String>, impl Into<String>>) -> Self

设置多个标签

pub fn delete(self, tag: impl Into<String>) -> Self

删除标签

pub fn delete_id(self, tag: TagId) -> Self

删除标签（使用 TagId）

pub fn overwrite_original(self, yes: bool) -> Self

覆盖原始文件（不创建备份）

pub fn backup(self, yes: bool) -> Self

创建备份

pub fn output<P: AsRef<Path>>(self, path: P) -> Self

输出到不同文件

pub fn condition(self, expr: impl Into<String>) -> Self

设置条件（仅在条件满足时写入）

pub fn arg(self, arg: impl Into<String>) -> Self

添加原始参数（高级用法）

pub fn offset(self, tag: impl Into<String>, offset: impl Into<String>) -> Self

日期/时间偏移

示例: .offset("DateTimeOriginal", "+1:0:0 0:0:0") 表示增加 1 天

pub fn copy_from<P: AsRef<Path>>(self, source: P) -> Self

从文件复制标签

从源文件复制所有标签到目标文件

pub fn execute(self) -> Result<WriteResult>

执行写入操作