Struct TimeLimitRule 

pub struct TimeLimitRule { /* private fields */ }

Stops the search once the time limit is reached.

It also serves as the search’s clock. When made relaxable, reaching the limit ends the current pass and the clock restarts for the next one.

Implementations

impl TimeLimitRule

pub fn new(time_limit: f64) -> Self

A rule that stops the search after time_limit seconds.

pub fn relaxable(self) -> Self

Makes the limit apply per pass rather than to the whole search.

pub fn elapsed_seconds(&self) -> f64

Seconds since the rule was activated or reset.

pub fn remaining_seconds(&self) -> f64

Seconds left before the limit, never negative.

pub fn exhausted(&self) -> bool

Whether the limit is reached.

Trait Implementations

impl Debug for TimeLimitRule

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

Formats the value using the given formatter.

impl Default for TimeLimitRule

fn default() -> Self

Returns the “default value” for a type.

impl Rule for TimeLimitRule

fn evaluate(&self, _context: &RuleContext) -> RuleResult

Decides whether the search continues below the node.

fn priority(&self) -> u8

Rules with a higher priority are evaluated first.

fn description(&self) -> String

A short human-readable name.

fn state(&self) -> RuleState

The current state of the rule.

fn activate(&mut self)

Starts applying the rule; called before the first pass.

fn deactivate(&mut self)

Stops applying the rule.

fn reset(&mut self)

Resets any internal state, such as a timer.

fn is_relaxable(&self) -> bool

Whether the rule restricts the search only temporarily. A search whose pass was cut by a relaxable rule is not finished.

fn relax(&mut self)

Widens the rule’s budget before the next pass, or deactivates it once the budget is at its limit.

fn as_any(&self) -> &dyn Any

Upcast used by RuleManager::get_rule_mut.

fn as_any_mut(&mut self) -> &mut dyn Any

Mutable upcast used by RuleManager::get_rule_mut.

fn is_active(&self) -> bool

Whether the rule is applied.

fn delay(&self) -> u8

Number of passes to wait before the rule takes effect.