Skip to main content

record_population_restrictions

Function record_population_restrictions 

Source
pub fn record_population_restrictions(
    state_dir: &Path,
    inert: &[String],
    stopped_after_inconclusive: Option<usize>,
) -> Result<(), String>
Expand description

Records, beside the ledger, every way a harvest narrowed the population it walked: the merges excluded as inert, and the consecutive-inconclusive run that stopped the walk early.

This exists so a corpus reader can tell a merge that was observed and found clean from one that was never observed, which a ledger of observations alone cannot express. Appends one versioned line per run, so an incremental re-run’s restrictions accumulate rather than overwrite. Writes nothing when a run restricted nothing.

§Errors

The state directory cannot be created or the record cannot be appended.