Struct FileMerge 

pub struct FileMerge {
    pub path: String,
    pub chunks: Vec<MergeChunk>,
    pub states: Vec<ChunkState>,
    pub cursor: usize,
    pub scroll: usize,
    pub follow: bool,
    pub ours_label: Option<String>,
    pub theirs_label: Option<String>,
    /* private fields */
}

一个文本文件的合并会话:块列表 + 各块解决状态 + 光标。

Fields

path: String

文件路径(git 模式为仓库根相对;单文件模式为输入路径)

chunks: Vec<MergeChunk>

合并块,首尾相接覆盖整个文件

states: Vec<ChunkState>

与 chunks 一一对应的解决状态

cursor: usize

光标所在块下标(始终指向非 Stable 块;无改动块时为 0)

scroll: usize

视口滚动行偏移(由 UI 维护)

follow: bool

视口是否跟随光标块(手动滚动后为 false,作用于光标的动作恢复跟随)

ours_label: Option<String>

本地侧栏头标签(分支名)

theirs_label: Option<String>

远端侧栏头标签(分支名)

Implementations

impl FileMerge

pub fn from_three_way( path: String, base: &str, ours: &str, theirs: &str, ) -> Self

由三份完整文本构建(git 三方模式)。

pub fn from_result( path: String, result: MergeResult, ends_with_newline: bool, ) -> Self

由已计算好的合并结果构建(冲突文件解析模式)。

pub fn chunk_resolved(&self, idx: usize) -> bool

某块是否已处理完毕(被覆写,或所有有效侧均非待处理)。

pub fn pending_conflicts(&self) -> usize

未处理完的冲突块数量(写盘的先决条件是归零)。

pub fn pending_changes(&self) -> usize

未处理完的改动块总数(含非冲突,状态条展示用)。

pub fn ready_to_write(&self) -> bool

文件是否可写盘:所有冲突块已解决(非冲突块保持待处理 = 保留 base)。

pub fn current_content(&self, idx: usize) -> Vec<String>

某块当前在结果中的内容:覆写 > 按取用顺序拼接 > base。

pub fn resolved_content(&self) -> String

导出整个文件的最终内容(按块拼接 + 末尾换行策略)。

pub fn apply(&mut self, side: Side)

取用某一侧:内容按点击顺序追加(冲突两侧先后取用 =「两者都要」); agree 块两侧内容一致,取任一侧即整块完成。

pub fn ignore(&mut self, side: Side)

忽略某一侧(该侧改动不进入结果);agree 块忽略即整块保留 base。

pub fn undo(&mut self)

撤销当前块的全部决定,回到待处理。

pub fn undo_all(&mut self)

撤销本文件所有块的决定(含 $EDITOR 覆写),全部回到待处理。

pub fn set_override(&mut self, lines: Vec<String>)

用 $EDITOR 编辑后的内容覆写当前块(视为已解决)。

pub fn apply_all_nonconflict(&mut self)

一键取用所有非冲突改动(ours/theirs/agree)。

pub fn next_change(&mut self)

移到下一个改动块(跳过 Stable)。

pub fn prev_change(&mut self)

移到上一个改动块(跳过 Stable)。

pub fn next_conflict(&mut self)

跳到下一个未解决的冲突块(到底后从头环绕)。

pub fn prev_conflict(&mut self)

跳到上一个未解决的冲突块(到头后从尾环绕)。

Trait Implementations

impl Debug for FileMerge

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

Formats the value using the given formatter.